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Pretace 


he HHC 1s distributed by Quasar Corporation and Olympia Corpos 

ration. An HHC from any of these companies can work equally well 

with peripherals, software, and capsules distributed by any of the 
olher companies. Since Olympia is the newest distributor of the HHC, 
details on the availability of specific peripherals and software were not 
avatlable when this book went to press. 

If you area new HHC user, this book contains step-by-step tutorials on 
every phase of HHC operation. This book also contains detailed descrip» 
tions of the operations of the latest peripherals and software to delight the 
most sophisticated and experienced HHC users. | 

Chapter | places the HHC inthe context of past and future developments 
inthe computing industry and includes a discussion of the best applications 
for using the HHC. 

Start-up procedures are listed in Chapter 2 along with an overview of the 
HHC system. 

The File System is covered in Chapter 3. In it you learn everything you 
need to know to create, delete, and manipulate files. Files atid the File 
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syalem are used inevery HHC application, from word processing to data 
eollechion and transmission. 

Chapter 4 introduces the calculating capabilities of the HHC, 

[The Clock; Controller discussed in Chapter 5 displays the time and sets 
and acknowledges alarms, The Clock/Controller can be used as an elee- 
fronic datebook with times and messages. 

Che function and program function keys and other special keys covered in 
Chapter 6 make the HHC more powerful and user-friendly. The Program- 
mible Memory Peripheral expands the storage capabilities of the HHC., 

Descriptions of the many applications programs which are available as 
program capsules for the HHC are contained in Chapter 7. These programs 
Include time-management and analysis, word processing, data collection, 
telecommunications and others. This chapter includes information on how 
to use cach program for maximum benefit. 

The three high-level languages the HHC supports are covered in Chapter &. 
snaprPORTH, the HHC’s system language compiler, and the two BASIC 
versions, Microsoft BASIC and SnapBASIC, are compared for their 
applicability to the different tasks you might wish to use a programming 
language for, 

Using peripherals, including the newest and most exciting peripherals, is 
covered in Chapter 9. The chapter shows you how to set up each peripheral 
and sugpests the most efficient ways to use the peripheral. With this chapter 
you can preview peripherals you don’t own. 

Important words and phrases are printed in italics in the text and are fully 
defined and described in the glossary, Appendix G. Warnings and cautions 
lor sale and efficient use of the HHC are boxed for easy reference and are 
gathered iato Appendix B, Other appendixes gather information on hard- 
ware and software internals, provide a quick reference, explain the character 
sel, and suggest further readings. Appendix E contains additional informa- 
lion for programmers hoping to do sophisticated work withthe TV Adaptor 
peripheral. 








Introducing the HHC 


ipital computers have been around for about forty years. During 
that time, advancing technology has continually made the machines 
Amatlerand more powerful. ENIAC, one of the earliest computers, 
weighed 340 tons and performed about a thousand operations per second, 
Fodwy a typical desk-top computer weighs a few dozen pounds and pe! 
larims more than a million operations per second. 

Portable computers are the latest step in this evolution. They give you the 
pawer of a desk-top computer ina package so small that you can easily slip it 
info your briefcase, 

Arthur C, Clarke’s novel /mperia!l Earth introduced the character Dun 
viti Makenzie, a twenty-third century citizen of Titan, and his MiniSee, & : 
handheld computer. Makenzie’s MiniSec connected to planet-wide compul 
pr kystermns Via phone lines in hotel rooms. It acted as a data collection device, 
pocket secretary, and electronic datebook for jotting down ideas, formulas, 
and plans, What Clarke wrote was not wide of the mark. The MiniSee in 
available today—in the Panasonic/ Quasar/ Olympia HHC! 

Upto now, three types of handheld computers have been in existence, [he 
lirsl type can be programmed in only one built-in, high-level language 
usually a limited form of BASIC, As a result, the library of programs that 
you can run on such # machine is small, and the capability of cach program 
is usually low 
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The second type of handheld computer is actually a programmable por- 
table terminal. This type of com puter is programmed in a language that is 
powerful but not easy to use. Phe computer is usually designed so that once a 
program ts written and installed in the computer, the computer can run that 
program and no other. Asa result. this type of computer is practical only for 
fixed commercial applications, with many people using the machine for a 
single purpose. 

The third type of handheld computer is the programmable pocket calcula- 
tor, The programming language for this type of machine consists mostly of 
the simple operations you perform by pressing the machine’s function 
keys—“add,” “display,” and so forth. This type of machine usually has less 
than a full typewriter keyboard and runs rather slowly. It is poorly suited for 
writing complex programs or writing programs that perform significant 
amounts of nonnumeric computing (for example, a word processing 
program), | 

These three types of handheld computers share certain other limitations 
They generally have a small data storage capacity and a limited ability i 
communicate with other computers and devices such as printers. 

The HHC, shown in Figure I-1, is the first handheld computer that can 
offer you as much power as desk-top computer systems selling for several 
thousand dollars. The HHC accepts a large library of plug-in programs such 
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Figure 1-1, The HHE 


| ai, ie, 





Chapter ft) fatroductng the HHO 4 


as specialized calculators, data entry systems, word processors, and more, 1 
can also accept a wide range of peripheral devices, including printers, video 
terminals, devices for communicating with other computers by telephone 
even a four-color plotter, 

The HHC isa little larger than a pocket scientific calculator. You can uae 
it as a datebook, a calculator, and an electronic notebook. With it you ean 
record your thoughts and ideas for later incorporation into business plans, 
memos, or articles. You can use it to run dozens of programs that record 
data, edit text, and perform “what-if” projections from financial or othes 
numeric data. If no prewritten program 1s suited to your needs, you can Use 
the HHC to write your own program in any of several different computer 
languages that you can plug in just as you would a specialized program, 

You can find many uses for the HHC in your business. If, for example, 
you have to keep track of your use of time for billing purposes, the HH 
with its TIME/ TRAC program can function as a highly automated portable 
time recorder. 

If you sell computers, the HHC can offer you many new marketing 
possibilities. Since it is easily programmed, it can be readily adapted to Itt 
“vertical marketing” niches in any specialized business that you are conduct 
ing or wish to enter. 

Telecomputing programs give the HHC data communications capabill 
ties, These programs let you collect data and perform computations while 
away from your home or office and then transfer the results to another 
computer by telephone. | 


WHAT THE HHC CAN DO 


The HHC is a very different device from conventional computers, Its. 
strong and weak points are different. If you have definite ideas about how 
computers should be used, working with the HHC is likely to broaden your 
outlook. 

Roughly speaking, the HHC is appropriate for applications requiring ni 
least one of the following capabilities: 


| A portable device for data collection. Examples of such applications 
include sales order entry, survey response recording, meter reading, 
inventory control, and time-billing recording. The HHC is ideal fos 
these applications, since it combines portability with great flexibility, 
Furthermore, the HHC ean be programmed to perform complex data 
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validation and user prompting, thus reducing the amount of attention 
the user must give to the computer. 


Telecommunications: rapid, accurate transfer of data from one com- 
puter to another. In sales order entry, for example, a sales person can 
transfer orders from the HHC in the field to the home office and 
transfer current inventory data from the office to the HHC in the field. 
An executive in the field can transfer letters and notes to the office for 
typing and examine electronic documents kept on file there. A reporter 
can use the HHC to write a story and then transfer the stary directly to 
the newspaper’s typesetting system, These tasks require only an HHC, 
a telephone, and a modem, a peripheral that can transfer computer 
data by telephone. 


Portable information processing. In addition to a built-in, four- 
function calculator, the HHC can run a scientific calculator and a 
spread sheet program. 


Sturdiness and compact size: computing in hostile environments. The 
HHC’s ruggedness and small size make it especially well suited to work 
in places where other computers can’t go. In some hospitals, for exam- 
ple, the HHC is used to calculate doses of anesthesia needed during 
surgery. To be used in the operating room, the HHC must be sterilized. 
Since this would have bad effects on any computer, the HHC is sealed 
into a plastic pouch before the entire pouch is sterilized. Running on 
battery power, the computer is used inside the pouch throughout the 
operation. | 

Process control: automatic control of a machine by a computer. The 
HHC’s small size and low power requirements make it ideal for process 
control, At the same time, its powerful system software and input; out- 
put facilities make it easy and economical to apply. 


Custom programming. Whenever no commercially available program 
fits your needs, you can develop a custom program (or have one 
developed for you). The HHC offers you a choice of several program- 
ming languages, making it possible to program the computer fora very 
broad spectrum of tasks. 
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random-aceess memory (RAM) storage. 

of input. The HHC’s keyboard is smaller (han a 
d. and most users cannot touch-type on i 
| involve large quanti 


Large quantities 
standard typewriter keyboar 
This makes the HHC inappropriate for uses that 
ties of keyboard input. | 
The HHC’s primary output medium ts it 
that is 26 characters long. This makes ihe 
lications that need to display large quant 


Large quantities of output. 
liquid crystal display (ECD) 
HHC awkward to use for app 
ties of data. 


Phere are also certain applications that are not appropriate forthe HHC. 
These applications tend to have some of the following requirements: 
' Large quantities of data, The storage capacity of the HHC is necessarily 
limited, The HHC alone can store about 7000 characters (7K) of data 











Getting Started 


Qn this chapter you will become [familiar with the controls on the HH 
und will learn how to run an HHC program. 

[he HHC models sold by Panasonic, Quasar, and Olympia are all 
manufactured by Matsushita Electric Company and are very similar, tie 
iNustrauions in this book happen to show only Quasar equipment, but the 
information applies to all three brands. We will refer to all brands of the 
computer as “the HH.” | 


A GUIDED TOUR OF THE HHC 


Hold your HHCso that the front of the machine faces away [rom you, its 
whown in Figure 2-1, 

Phe rectangular panel on the back can be lifted off by pulling up on the tah 
Head Co the legend OPEN, Lift the panel, as shown in Figure 2-2, and look at 
the compartment beneath, The compartment has three sockets for TILe 
cuprsules contaming application programs, 

If you have purchased an HAC capsule containing an appheation pra 
Bram, plup wointo any one of these sockets, The capsule and sooket ape 
shaped so that you cannot insert the capsule the wrong way, Pigure 3.4 
demonstrates eapsule isertian 
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Figure 2-1. Back view of the H HC 


Figure 2-2, Program ca psule compartment with one Capaule in plier 
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Vigure 2-3. Program capsule being inserted into socket 


Now reattach the panel that covers the HHC capsule sockets. Above the 
left end of the panel is a rectangular hole containing a slide switch, This is the 
ALL-OFF switch, so named because it controls the HHC’s power supply and 
ean turn off all parts of the HHC. 

Use a slender object such as a pencil to move the ALL-OFE switch to its ON 
position. 

The ALL-OFF switch may stay on at all times—evyen when you put the 
MITC away at the end of the day. That way the HHC can keep power on its 
memory and preserve the data stored there. You should turn off the ALL» 
OFF switch, however, in the following two situations: 


‘ If you are putting the HHC away for a period of weeks or more, 
Preserving the contents of the HHC’s memory could drain the batteries 
completely; if this happens repeatedly, the batteries’ ability to hold a 
charge could be reduced. Turning off the ALL-OFF switch can prevent 
such a problem, 


' df you are shipping the HHC by mail, in luggage, and so forth, Such 
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— treatment may subject the HHC to extremes of heat or cold, conditions 
it can better tolerate when turned off. 


The Right Side 
Turn the HHC so that its front faces you. Find the circular hole on the 
HHC’s night side, shown in Figure 2-4, This hole is a socket for an AC 
Adaptor, which operates the HHC from AC power and recharges the 
HHC’s batteries. 
Two AC Adaptors are made for the HHC. The standard AC Adaptor 
weighs about two pounds and can deliver enough power to run the HHC 
with any combination of peripherals. A smaller AC Adaptor is about half 
the size and weight of the standard one and delivers enough power to run the 
MHC and one peripheral, although it cannot accommodate certain periph- 
crals with high power requirements. 
Plug the AC Adaptor’s jack into its socket on the HHC and plug the AC 
Adaptor’s power cord into an electrical outlet. 
The batteries can operate the HHC for many hours. To keep the batteries 
fully charged, however, use the HHC with the AC Adaptor whenever it is 
convenient to do so. As long as the HHC’s ALL-OFF switch is set to ON, the 
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Figure 2-4, Right side of HHC: AC power jack 


Chapter 2: Getting Started |] 


AC Adaptor, whenever plugged in, will charge the HHC’s batteries. 

If you try to use the HHC when the batteries are nearly exhausted, it 
displays the message “BAT LOW”. This signal! suggests that you had better 
plug in the AC Adaptor to recharge the batteries. 


Caution: Many AC Adapectec can 1 be set to operate. on either 110-volt 
or 220-volt power. Be sure your AC Adaptor is set for the voltage that 
your electrical system provides. If you try to use the AC peje at the 
wrong is you may damage it seraiele 7 ne 


The Left Side 


Notice the slot-shaped socket on the HHC’s left side, shown in Figure 2-5, 
This socket 1s where you can plug in an HHC peripheral. 


Figure 2-6, Left vide of HIIC; bus slot 
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Figure 2-6. The HHC keyboard 


The Keyboard 


To the right of the main keyboard shown in Figure 2-6 are the ONand OFF 
keys, You use these keys to turn the HHC onand off in everyday use. Unlike 
the ALL-OFF switch on the back of the HHC, the OFF key does not interrupt 
the flow of power to the HHC’s memory. Thus, when you turn the HHC to 
OFP, the program it is running and the data that is stored in its memory will 
not be disturbed. 

Below the ON and OFF keys is the CLEAR key. Use this key to reset the 
HtHC when you have finished running most programs. 


Caution: When you have finished running a program, always wait ae 
second or so before pressing CLEAR. any bogie needU this time to 
store their data in an eee way. 


On the left half of the keyboard are the typing keys, used to enter such 
displayable characters as A, Q, 3, and ?. 


The ENTER key, located near the lower right corner of the keyboard, is 


similar to a typewriter’s RETURN key. 
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On the right side of the main keyboard are the editing keys, used (among 
other things) to edit data. The editing keys are 


fololofo}ololol'ololo|S{S| 5] |S) 
Q %IW CM RM+]T M-|}¥ +] U STP/SPO OFT 
falolalelalolslslofofsfols| |o 
] K >IL fl SEARCH ROTATE CLEAR 
fa folololofelo|oolo [SS 7S] fo! 
ay B @ INSERT F DELETE | LOCK 
fofolofolfeloleolofolSfels| | 
cl C2 C3 c4 ? ENTER SHIFT 
fo foo fool FES fo| RSS] | 


The four program function keys are located in the lower left corner of the 
keyboard. Labeled c/ through C4, these keys are used to control many of the 
programs that run on the HHC. Sometimes they also — as typing 
keys, producing the special characters “a,” “é,” “ti,” and “ 


fofololoofolo|ofololS] [5] [6 
ce) | Ea) fees ES Tt Be ee ae ra Ly 
% IW CM RM+/IT M-]|Y +]/U —- STP/SPO OFF 
fofolalslSlofolsl[ofol/Sfols| |S 
f1 SEARCH ROTATE LEA 
fofolololololol's/ole[olS[s] fo! 
B @ {2 INSERT | DELETE | LOCK 
Alara RARE rr 
elo] ele) SIs) | 
ee 


The remaining keys perform control functions for the HHC. These keys 
are 
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B @ INSERT DELETE 
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The function keys, labeled f/ through f3, let you type three frequently used 
keystroke sequences by pressing a single key. The HELP key lets you display 
a brief explanation of a particular key’s function. The //O key turns periph» 
eral devices on and off and lets you select different memory devices contain« 
ing programs and data. 

The STP/ SPD key “freezes” the HHC, halting a program run so that you 
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can inspect the output. The STP/SPD key also lets you control 

) th 

which the HHC displays data. : —— 
The LOCK key locks the effect of another key, somewhat like the SHIFT 

LOCK key on a typewriter. The SH/FT key and the 2nd SFT key let you type 

upper-case letters and special characters. 


| oi learn more about the HHC, these keys will be discussed in greater 
detail. 


The Liquid Crystal Display 


Above the keyboard is the Jiguid crystal display—LCD for short. The 
[L.CD can display one line of 26 characters. | 

Press the ON key now to turn the HHC on and see how the LCD looks in 
operation. (You may have to press the CLEAR key once or twice to make the 
LCD display something.) Press the OFF key to turn the HHC off again. 
| [he LCD can display ordinary characters, inverse image characters—that 
Is, Clear characters on a black ground—and flashing characters. The LCD 
can also display special symbols and graphics, since HHC programs can 
directly manipulate the dots in LCD’s dot matrix. 

J ust below the LCD is the row of words and symbols [=@|]SHIFT LOCK 
2nd SFT DELETE INSERT ALARM ON LINE. Along the bottom of 
the LCD, the HHC displays a row of triangular blips, images that point to 
the row of words below the LCD and display information about the status of 
the HHC. When you press the SHIFT key, for example, the SHIFT blip goes 
on, The =i blip has no predefined meaning, soan HHC program is free to 
use this blip for any purpose. 

lurn the HHC on again. Press the SHIFT key to see what a blip looks like 
Press the SHIFT key again to turn the blip off. Now turn the HHC off. | 


INSIDE THE HHC 


Phe “brain” of the HHC is a 6502 microprocessor—the same micro- 
processor that is used in such popular computers as the Apple II and 
Commodore CBM series. 

The HHC’s overall operation is managed by the operating system, a 
program that is permanently stored in the HHC’s read-only memory 
erg ). Three commonly used application programs are also stored in the 
| The HHC contains read/write random-access memory (RAM) for stor- 
ing data, Depending on your model of the HHC, there may be approx 
mately 4000 or 8000 bytes (characters) of RAM, i 





Chapter 2) Getting ati wit = | by 


The HHC’s batteries deliver power to RAM at all times; thus, even when 
turned off, the HHC can preserve its memory. The HHC uses a special low 


power type of RAM that can run off the batteries for several months without 


exhausting their charge. 
These internal components of the HHC, and their interrelationships, are 


shown in Figure 2-7. 


THE HHC ACCESSORIES 


Let’s take a quick look at some of the accessories available for the HH, 
Every HHC comes with 
- Asoft plastic carrying case that you can use to protect your HHC when 
it is not in use 
- A carrying strap that you can clip to a small lug mounted underneath 
the HHC’s upper right corner 
A plastic sleeve that slides into the groove around the sides of the HH, 


You can use this sleeve to hold together the HHC and a peripheral. You 
can also slide the sleeve over the face of the HHC to protect the 


keyboard from accidental pokes. 
The Programmable Memory Peripheral (PMP) contains up to 16K al 
additional RAM. You can use it to store HHC programs and data; tt ik 


shown in Figure 2-8. 

Several other peripheral devices are available for the HHC including an 
RS-232C Interface for printers, video terminals, and similar equipment, 
Modem for telecommunications; a TV Adaptor for display of text and 
graphics ona TV or video monitor: a battery-powered portable printer, and 


6502 Central Processing Unit (CPU) 
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Figure 2:7, Internal components of the HHC 
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Programs are most often distributed in Capsules that you plug into one of 
the sockets on the back of the HHC. Less frequently, they are distributed in 
device driver capsules that you plug into a peripheral] device. 

Oftenan HHC program is accompanied byakeyboard overlay, a rectan- 
gular sheet of Plastic that you place over the keyboard when using the 
program. This overlay, shown in Figure 2-10, relabels some of the HHC keys 
(o reflect their functions more clearly in a particular program. — 

The attache Carrying case, shown in Figure 2-11, is a specially fitted case 
that can hold an [/O Adaptor with an HHC and peripherals. The case also 
has space for an AC Adaptor. A pouch inside the lid can store several 
instruction manuals and keyboard Overlays, 
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Figure 2-9. The RS-232C Interface, Modem, Micro Printer, 
° I/O Adaptor, TV Adaptor, and PMP 
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This is the HHC's primary menu. It tells you what programs in the HHO 
are available for you to run. 

A “menu” is so named because—just like a restaurant menu—it contains a 
list of options that you can choose. You choose an option by pressing the 
number key that the menu lists for a particular program. 

The primary menu is the starting point for everything you do with the 
HHC. If you press the CLEAR key repeatedly, it will always return the HHC 
to this menu. 

Let’s try the menu to see how it works. Press the 1 key, which chooses the 
program entitled Calculator. After you press 1, the HHC displays 
“CALCULATOR” on the LCD. It then displays the digit “0” and waits for 
you to enter the calculation you want it to perform. 

To leave the Calculator, press the CLEAR key twice: once to clear any 
calculation you may be performing (you aren’t doing one, so nothing 
happens) and once to return the HHC to the primary menu. 

Let’s try another program. Press 2 for the Clock/ Controller or 3 for the 
File System. Each of these programs displays another menu from which 
you can make a selection. Many HHC programs work by presenting il 
succession of menus that let you specify exactly what you want the HHC to 
do. 

Again, you must press CLEAR twice to return to the primary menu. Do so 
now and turn the HHC off. 





Figure 2-11. Attache case, holding the HHC and peripherals 


THE AUTO-OFF FEATURE 


If you leave the HHC on without pressing any key for a period of about 
ten minutes, the HHC will turn itself off. This awto-off feature protects you 
from draining the HHC’s batteries should you forget to turn off the HHC, 


THE PRIMARY MENU 


, cytes a program on the HHC, turn the HHC on. Then press the CLEAR 
ey, ll necessary, to make the LCD display start changi 
- the following LCD display: Mg ging. You should see | . 
CARING FOR THE HH 
The HHC’s extreme portability does not remove your responsibility to 
care for it properly. You must protect the HHC from impact and other 
physical hazards, and you must not abuse the batteries. 
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Protection | 

Your HHC is designed to be rugged and reliable, but it is stilla complex 
electronic instrument and contains delicate parts. Protect it from being 
dropped on conerete, struck with heavy blunt instruments, and so forth, 


[ARUN ONAP PROGRAMS) 


‘oe RUN SNAP PROGRAMS 
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The most delicate part of the HHC is the faceplate of the LCD. Made of 
fairly soft plastic, the faceplate is liable to be scratched if the HHC is thrown 
loose into a drawer or an attache case. Protect the HHC by slipping it into its 
soft plastic carrying case or sliding the rigid plastic sleeve over its face. 


Temperature Extremes 


The operating range of the HHC and its peripherals is 0°C to 40°C 
(approximately 32° F to 104° FP), 

The HHC may be stored or shipped safely at somewhat lower and higher 
temperatures if the ALL-OFF switch is moved to the OFF position. 


Caring for the Batteries 


Your HHC is delivered with rechargeable nickel-cadmium batteries, 
which will last indefinitely with proper care. 

When your HHC is delivered, the batteries will probably have no charge. 
Leave your HHC connected to an AC Adaptor to charge the batteries. An 
overnight connection should charge the batteries fully. 

To charge the batteries quickly, leave your HHC turned off. Youcanalso 
charge the batteries while the HHC is in use, but the charging process will 
take longer. How much longer depends on how heavily the HHC (or any 
connected peripheral device) is being used. 

The first few times you charge the HHC’s batteries, you should expect 
them to run down quickly. After several recharges, the batteries’ ability to 
hold a charge will increase to normal. , 

Since it takes some power to preserve the contents of the HHC’s memory, 
the batteries gradually lose their charge when the HHC is turned off. Even if 
the ALL-OFF switch is off, the batteries will gradually lose their charge 
spontaneously. 

Do not allow the batteries to remain uncharged for long periods of time; 
they may permanently lose their ability to hold a charge and have to be 
replaced. Recharge the batteries about every six months, even if your HHC 
is unused, 

Should your HHC’s batteries become exhausted or damaged, take your 
HHC to a qualified maintenance service to have the batteries replaced. 








The File System 


he role of files in the HHC. You will learn to 


iscusses t 1; 
his chapter di d modily 


use the HHC File System, which enables you to create an 
text files through the keyboard. 


WHAT IS A FILE? 


File is a computer term for a collection of data grouped together aoa 
one name. The HHC File System is analogous toa conventional rp 
yystem; one file folder usually contains a specilic collection = onus poe 
example, one file might contain information about orders and paym 
(rom a particular customer. 

Just as a conventional file is stored in a folder, | 
stored on some particular medium. Reels of magnetic tape, map , a 
and punched cards are examples of media that can be used to stor econ : 
files, On the HHC, the most important medium for file storage 1s fas ns é 
RAM. The HHC’s intrinsic RAM is used for storing files and programy, 


al. 


a computer file must be 
etic disks, 
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A file can contain any sort of data that the HHC can process. Some 
common uses for files are 


, Storing text. For example, a file may contain notes that you write to mary hacia little lamb 
yourself; documents that you have created with a text editor; or reports 


generated by application programs. 


name and press the ENTER Key to get 


’s edi ing and then 
‘ Storing data. A file may contain any sort of data that you create for | When you press ENTER, the File raagenne se pen LCD will be 
input to a program. A program may also create a file for input to displays the first line of the file. Because thi 
another program. blank. 


The cursor, a solid blinking rectangle at the left edge of the display, 
‘ndicates where the next character you type will go in the current line. | 
Study the following information, which you will soon enter—errors ane 


‘ Storing a program. If you write your own programs for the HHC, you 
will generally keep them in files. 


+ Storing system data. Some parts of the HHC’s operating system use all—in your file: 
files to store data that they must preserve. For example, the operating 
system component that controls the RS-232C Interface stores that mary had a little lamb, 
device’s configuration parameters in a file. These files are “invisible” to its fleece was white as snoe, 
you, since only the computer uses them. an everywhere that mary went 


the lambb was sure to go 


| , x in *vou'll learn how to correct 

In this chapter’s section on “Correcting Errors you . 

eee ; (he preceding errors for practice in using the editor. (if you make some 
additional errors on your own when you enter the poem, so much thw 


better.) 


The File System, option 3 on the HHC’s primary menu, allows you to 
create, modify, and manage text files by typing on the HHC’s keyboard. . | 
The File System has an editor that allows you to create or modify one file To place the first line of the nursery rhyme in the first line of the file, 


ata time. The file being edited is called the current file. Within the current - simply type the data on the HHC’s keyboard. When you finish typing a line, 


file, the editor displays one line at a time for you to inspect and modify. This press ENTER. The File System will move the cursor to the start of the neat 
line is called the current line. 


line, just as if you had pressed the RETURN key on a typewriter. 
Turn on your HHC and choose option 3. The HHC displays “FILE 


Since the second line of the poem is more than 26 characters long, it won’! 
SYSTEM” to tell you what program it is running and then displays a menu fit on the LCD. When you type the 27th character, the editor scrolls the 
that looks like the following: 


display and the beginning of the line moves off the LCD so that you can see 
(he characters you type at the end. The File System lets you create a line up 
pee to 80 characters long. 


weno ll Naming a File 
A file name may be any length from one to 80 characters, and it may 
ae - include blanks, punctuation, or any other character that youcan type on the 
HHC keyboard. Every character is significant, and upper or lower case of 
aS HeGiS. GpUGR te Now she vile Bistein Prompis you fo (ypea mena every letter is significant, If you name a file “March AR”, for example, tliat 
and press ENTER, Let’s name this file “mary had a little lamb”. Type that name is distinct from “Mareh ar”, “March A.R.”, or “MARCH AR”, 
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Because the LCD holds 26 characters, keep the length of the name to 24 


characters or fe T sae 
rs or fewer. The number and “ = ” take up two characters. 


Saving a File 


| Alter you have ended the last line of your file by pressing ENTER, press the 
CLEAR key, This saves the file and returns you to the File System menu. Now 


the menu displays 


L=NEW FILE 
2=COPY FILE 


J=mary hada little lamb 


Notice how completely your file name describes its contents, Most other 


— do not allow a file name that is this long or that consists of several 
words. 


Retrieving a File 


l'o edit the file again, choose option 3, which the File System menu now 
tells yous the mary had a little lamb” file. The File System displays the file 
name, first in ordinary characters and then in inverse image characters, with 





the cursor immediately after it. And so you see 


[mary hada little lamb | 
[nary hada little lamb] | | 


: ress the | key, which ts located near the right side of the keyboard. The File 
ystem s editor moves “down” from the file name to the first line of the file. 
Notice that you can press ENTER in place of | to move the cursor to the 


next line, The reverse is not true: you cannot press | to create a new line at the. 


end of the file, In that case you must use ENTER. If you use | and no line 
CXists alter the current line in the file, the editor beeps to indicate that you 
have tried to move beyond the end of the file, | 
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Cursor Control for Moving Through a File 


Using the four arrow keys, try moving the cursor around within the file, 
Notice that you can move the cursor in all four directions. If you try to move 
the cursor to a part of a line that is not on the LCD, the File System 
obligingly scrolls the line for you. You can’t move the cursor before the first 
line of the file or more than one line past the last line, nor can you move the 
cursor before the beginning of a line or more than one character past the end 
of a line. When you first enter the editor, the | key moves you from the file 
name down to the first line of the file; but the f key will not move you up 
from the first line of the file to the file name. If you try to move the cursor 
“gut of bounds” the editor will not move the cursor, but will beep. 

When you display a line that is more than 26 characters long, the File 
System scrolls through the entire line. You can halt it at any point by 
pressing any typing key or editing key once. 


CORRECTING ERRORS 


Now let’s correct those errors that you introduced into the “mary had a 
little lamb” file. In the passages that follow you will learn how to substitute 
characters, insert or delete text, and use the File System’s capabilities to do 
more extensive editing. 


Change a Character 


The first error is located at the end of the second line, where “snow” Is 
spelled “snoe”. You can correct this kind of error simply by placing the cursor 
over the incorrect character and typing the correct character. 

Move the cursor to the second line with | or ENTER. Then move it over the 
“e” in “snoe” with ~. When you press w, the character “w” replaces the a 
and the cursor moves forward one character. 


Insert a Character 


The next error is located on the third line, where the “d” is missing in 
“and”. Here you must insert a character within a line. You can insert a 
character by placing the cursor immediately after the insertion point. Press 
the INSERT key and then enter the character you want to insert, 

Move the cursor down to the third line by pressing }, and move it back to 
the space following “an” with —. Here's a hint—hold down the = and, alter a 
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brief pause, the key will auto-repeat until you release it. All of the HHC’s 
(yping keys and most of the editing keys do this. 

Notice the four bars at the right edge of the LCD. The editor displays this 
symbol when the right end of the line is off the LCD. 





an Mleverywhere that mary we= 


Pressing INSERT causes the following: The cursor changes from a solid 
rectangle to a checkerboard pattern, and the INSERT blip on the LCD goes 
on, 





an WM everywhere that mary we= 





Press the d key. The cursor moves one position to the right and returns to 
its normal solid form. The space that was under the cursor and all the 
characters following it move one position to the right. A “d” is inserted 
where the cursor was, and the INSERT blip goes off. 

The INSERT key applies to one character at a time. If you want to insert a 
whole word into a line, you must press INSERT before each letter in the word. 
(You'll learn a way to avoid that dull chore in a later section.) 

It’s very easy to extend a line. Position the cursor at the end of the line and 
type. You don’t have to press INSERT to do this. 


Delete a Character 


The next error is located in the fourth line, where “lamb” is spelled with 
two “b"s. You must delete one “b”. You can delete a character by placing the 
cursor over that character, pressing the DELETE key, and pressing — or —. 

Place the cursor over either “b” in “lambb”. Pressing DELETE changes the 
cursor from a solid rectangle to a hollow one and turns on the DELETE blip 
on the LCD. 


[the lamblQ) was sure to go. } 


Now press —, Notice that the cursor remains in place but returns to its- 
normal solid form. The “b” that was under the cursor is deleted, all the 
characters following it are moved one position to the left, and the DELETE 
blip goes off. Like INSERT, DELETE applies to one character at a time, 
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Before: {ts fleec€) was white as sn= 
After: itfg) was white as snow 
Before: its (fleece was white as sn&= 
After: its las white as snow 


Figure 3-1. “Delete Left” and “Delete Right” 


Delete “Right to Left” 


You can delete a character by pressing DELETE ~<, as well as by pressing 
DELETE —. But DELETE + produces a slightly different effect: Instead of 
leaving the cursor in place, it moves the cursor one position left. 

Let’s try this. Reinsert the “b” that you just deleted from “lamb” 
remember, position the cursor, press INSERT, and then type the letter you 
want to insert. Now place the cursor on the extra “b” and press DELETE ™, 

You can think of DELETE < as “delete left.” If you enter this sequence 
several times, it deletes a string of characters running left from the character 
under the cursor, as shown 1n Figure 3-1. 

Similarly, you can think of the DELETE — sequence as “delete right.” If 
you enter this sequence several times, it deletes a string of characters running 
right from the character under the cursor ( Figure 3-1). 


Cancel a DELETE or INSERT 


If you press INSERT and then decide you don’t want to insert a character 
after all, just press INSERT again. The second INSERT cancels the effect of the 
first. Similarly, if you press DELETE, a second DELETE will cancel the effect 
of the first. 

You can also move directly from INSERT to DELETE by pressing DELETE, 
or from DELETE to INSERT by pressing INSERT, 
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SHIFT AND 2nd SFT 


Now you're going to learn how to enter capital letters and special 


characters, To practice these techniques, you'll correct the capitalization. 


and punctuation in your file. 

You lype a capitalized letter by pressing the SHIFT key, but the HHC’s 
SHIFT key works a little differently from a typewriter’s SHIFT key. On a 
typewriter you hold the SHIFT key down while you press a typing key. On the 
HHC, you press the SHIFT key before you press a typing key. Let’s try it. 
Place the cursor over the “m” at the start of the first line. Press SHIFT and 
then release it. Notice that the SHIFT blip went on. Now press M. The File 
System replaces the “m” in “mary” with a shifted—capitalized_—-*M”, and 
turns the SHIFT blip off again. 

You may shift several characters in a row by holding down the SHIFT key 
while you type, but you must release the SHIFT key before you type the last 
character that you want to shift. 

For practice, capitalize the first letters on the remaining three lines and the 
n” in the nursery rhyme’s second occurrence of “mary.” 

Now what about punctuation? Most of the HHC’s punctuation characters 
are located in an additional case called second shift. To get a semicolon, 
colon, or any other second shift character, press the 2nd SFT key before you 
press the typing key. 

The second line of your file should end with a semicolon, not a comma. 
The semicolon is the second shift character located on the “comma” key. 

Place the cursor over the comma at the end of the second line. Press 2nd 
SFT and then release it. Notice that the 2nd SFT blip went on. Now press the 
“semicolon” (or “comma”) key. The File System replaces the comma witha 
semicolon and turns the 2nd SFT blip off again. 


The keys SHIFT and 2nd SFT are like INSERT and DELETE in the following 
Ways: 


44 
t 


* ‘They act on only one character at a time. 


* If you press SHIFT or 2nd SFT and then decide you don’t want a shifted 
character, you can press the same key again and the second action will 
cancel the effect of the first. 


* You can move directly from SHIFT to 2nd SFT by pressing 2nd SFT or 
from 2nd SFT to SHIFT by pressing SHIFT. 


Notice the following unusual properties of SHIFT and 2nd SFT: 


‘ In the second row of the keyboard the symbols CM to + (on the W 
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through O keys) look like second shift characters but are not. They are 
special symbols used by the Calculator program. If you use any one of 
these keys with 2nd SFT in the File System, you will get a blank. 


- You can type the symbols ! to_ (on the | through 0 keys) with either 
SHIFT or 2nd SFT. 


- The symbols? and / are on the same key; but ?is an unshifted character 
and / is a second shifted character. This is the opposite of the usual 
typewriter arrangement. 


The LOCK Key 


Suppose you want to CAPITALIZE A GROUP OF LETTERS te E 
THIS ONE. Pressing SHIFT before each letter would be quite a bore; the 
HHC solves this problem with the LOCK key. - “ 

To type a series of shifted characters, press LOCK and then SHIFT. Notice 
that the LOCK and SHIFT blips go on. Now everything you type will be 
shifted until you press SHIFT again, which will return you to unshifted mode, 

Try using LOCK SHIFT to add some shifted characters to your 18, cee 

Similarly, to type a series of second shifted characters, press LOCK and 
then 2nd SFT. After the LOCK and 2nd SFT blips go on, everything you type 
will be second shifted until you press 2nd SFT again to return to the unshilted 
mode. S | 

You can also cancel LOCK SHIFT by pressing 2nd SFT. This action puts (he 
HHC in second shift for one character and then returns it to unshif ted mode, 
Similarly, you can cancel LOCK 2nd SFT by pressing SHIFT, and at this point 
the HHC will shift for one character and then return to unshifted mode, 


The LOCK Key with INSERT and DELETE 


You can use LOCK in conjunction with INSERT and DELETE, as well is 
with SHIFT and 2nd SFT. — 
To illustrate this, delete the word “fleece” from the second line 0 the fi ! 
Begin by placing the cursor on the first letter of “fleece” and pressing ot K 
DELETE. Notice that the cursor changes to its “delete” form and the DELP 
blip goes on. (The LOCK blip does not go on, it is displayed with SHIFT an 
2nd SFT only.) | 
Now press — once for each character you want to delete, When you have 
finished deleting, press DELETE once more to cancel LOCK DELETE, Notice | 
that the DELETE blip goes off, ) 
To reinsert the word “fleece”, place the cursor on the first character o 
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“was”, the place where the word “fleece” should begin. Now press LOCK 
INSERT, At this point, the cursor changes to its “insert” form and the INSERT 
blip goes on. The LOCK blip does not. Now type the word “fleece” and thena 
space, and press INSERT once more to cancel LOCK INSERT. Notice that the 
INSERT blip goes off again and the cursor returns to its regular solid form, 


Caution: Remember to cancel LOCK DELETE or LOCK INSERT when 
you have finished deleting or inserting. If you press ENTER or any of the 
arrow keys while DELETE or INSERTis in effect, you will delete or insert 
characters or lines in your file. = 


Open Up Space In a Line 


The File System allows you to create Space within a line and type 
characters into the space. This is sometimes more convenient than typing 
text with INSERT, 

To insert a space, press INSERT and then — or —. Each time you press —, 
(he cursor is moved one position to the right and a space is inserted in the line 
al the cursor. Each time you press --, the cursor does not move, buta space Is 
inserted at the cursor. 

Use + and — with LOCK INSERT to insert severa] spaces, Press LOCK 
INSERT =~ —,..,and the HHC inserts several spaces and leaves the cursor on 
the first space. Press LOCK INSERT — ..., and the computer inserts several 
spaces and leaves the cursor on the last space. Remember to cancel LOCK 
INSERT when you have finished inserting spaces. 


DELETE/INSERT and SHIFT/2nd SFT 
In Other Programs 


The DELETE, INSERT, LOCK DELETE, and LOCK INSERT operations that 
you have learned are part of the File System. Most other programs apply 
these keys the same way for entering text, but many programs use the keys 
for different functions in different contexts. Such programs are accom- 
panied by keyboard overlays that relabel the keys to reflect their functions. 


On the other hand, the SHIFT, 2nd SFT, LOCK SHIFT, and LOCK 2nd SFT ~ 


operations that you have learned are part of the HHC’s Operating system. 


Thus, these keys work the same way for every program that runs on the 
HH, 





Chapter 3! The File Sytem YY] 


LINES 


You can use the INSERT and DELETE keys to insert and delete whole lines 
in a file, as well as characters in a line. 


Delete a Line 


To delete the second line of the poem, place the cursor anywhere on the 
second line and press DELETE and }. The File System deletes the line and 
moves the cursor, making the next line (formerly the third) the current line. 
(Figure 3-2.) 

Pressing DELETE and ft deletes the current line and moves the cursor up to 
make the preceding line the current line. 


Insert a Line 


To reinsert the deleted line, move the cursor up to the first line of the file. 
Press INSERT, then | (or ENTER), as shown in Figure 3-3. The File System 
creates a new, empty line after the first line and moves the cursor to the 
empty line. You may now type in the line. 

To create a new, empty line before the current line, press INSERT and f, ij 
sequence depicted in Figure 3-3. Notice that the cursor moves to the empty 
line. - 


Mary had a little lamb, 
Its fleece was white as snow; 
And everyuhere that Mary went 
The lamb was sure to qo. 


After DELETE}: Maryhada little lamb, 
And everywhere that Mary went 
The lamb was sure to go. 


After DELETEt: Maryhada little lamb, 
And everywhere that Mary went 
The lamb was sure to go. 





Figure 3-2. “Delete Up" and “Delete Down" 
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Before: Maryhada little lamb, 
And everywhere that Mary went 
The lamb was sure to ga. 


After INSERT}: Maryuhada little lamb, 


And everywhere that Mary went 
The lamb was sure to go. 


After INSERT? : 
Mary hada little lamb, 
And everywhere that Mary went 
The lamb was sure to go. 


Figure 3-3. “Insert Up” and “Insert Down” 


LOCK DELETE and LOCK INSERT for Lines 


The keys LOCK DELETE and LOCK INSERT affect lines as well as individual 
characters. 

lor example, to delete several lines, place the cursor on the first line to be 
deleted and then press LOCK DELETE! | |. Each } deletes the current line and 
moves the cursor to make the following line the current line. After you have 
deleted the desired lines, press DELETE again to cance] LOCK DELETE. 

To insert several lines, place the cursor on the line that the inserted lines 
will follow and then press LOCK INSERT } (text) | (text) | (text). After you 
have entered the last line of text, press INSERT again to cancel LOCK INSERT. 


Locking Arrow Keys 


You can press LOCK before an arrow key to make any editing command 


wuto-repeat. The command will simply execute continuously until it reaches _ 


a “natural” stopping point, or until you interrupt it by pressing any typing or 
editing key. 

For example, to move the cursor left one character, press ; to move the 
cursor to the beginning of the current line, press LOCK —, The beginning of 
the line is the “natural” stopping point for this command, You ean atop the 
cursor'’s Movement by pressing a typing or editing key, 
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Similarly, to move the cursor to the end of the current line, press LOCK=*; 
to move the cursor to the first line of the file, press LOCK t; and to move the 
cursor to the last line of the file, press LOCK |. 

To delete all characters from the immediate left of the cursor to the start of 
the line, press LOCK DELETE LOCK ~. To delete all characters from the 
cursor to the end of the line, press LOCK DELETE LOCK ~. 


The ROTATE Key 


To review the entire contents of a line that is too long to be displayed on 
the LCD, press the ROTATE key, located on the right side of the keyboard, 
The ROTATE key continuously scrolls the current line across the LCD from 
right to left, separating the end of the line from the beginning by several 
blanks. Press any typing or editing key to make the LCD stop rotating. 


SEARCH 


To search a file for a particular string of characters, press the SEARCH key 

while editing the file. The File System prompts you with the phrase 
“SEARCH FOR?” Enter the string you want to search for. (It may be up to 
12 characters long.) Now press ENTER. 
_ If SEARCH finds the string you entered, it displays the line containing the 
string with the cursor on the first character of the string. If SEARCH does not 
find the string, it beeps, briefly displays the message “NOT FOUND", and 
redisplays the current line. Now let’s try SEARCH. 

Move the cursor to the beginning of the file and then press the SEARCH 
key. When the File System prompts you with “SEARCH FOR?”, type inthe 
string “white” and press ENTER. The File System displays the second line of 
your file and leaves the cursor on the “w” at the beginning of the string 
“white”. 


Where SEARCH Starts 


When pressed, the SEARCH key starts searching at the position of the 
cursor and searches to the end of the file. If it hasn’t found the string by then, 
it goes to the beginning of the file and searches as far as the cursor, Let's 
demonstrate this. 

With the cursor still on the string “white”, press SEARCH, type in the string 
“Mary”, and press ENTER, The File System finds “Mary” in the third line, 
ainee that is the firat occurrence of “Mary” at Cor alter) the cursor, 
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Without moving the cursor, repeat the search. Press SEARCH, type in 
“Mary”, and press ENTER. The File System leaves the cursor right where it 
is. Do you see why? 

Remember, SEARCH looks for the first occurrence of the string at—or 
after—the cursor. If the cursor is on the first character of “Mary”, SEARCH 
will find “Mary” right there. 

Now move the cursor one position to the right and repeat the SEARCH 


again. This time SEARCH does not find the string “Mary” anywhere before - 


the end of the file, so it returns to the beginning and finds “Mary” there. 


Strings Rather Than Words 


Note that SEARCH looks for a string, not a word or a group of words. A 
string is any consecutive group of characters on the same line. It does not 
necessarily begin and end with a blank. 

To demonstrate this point, move the cursor to the start of the file and 
search for the string “as”. Now the SEARCH key finds the string in the second 
line—not in the word “as”, but in the word “was”. Move the cursor to the 
right at least one position and search again. This time SEARCH finds the 
word “as”, which is the next occurrence of the string “as”. Move the cursor 
to the right and search again; now SEARCH finds “as” in the fourth line, 
again in the word “was”. 

You can find a word by searching for a string that consists of the word 
surrounded by blanks. To find the word “as” in our poem, search for the 
string “basb” (where “6” represents a blank). However, if you search for a 
string that begins and ends with a blank, you will miss words that begin or 
end a line. Thus, the “surrounded by blanks” technique is most useful when 
you are referencing a printout of the file and you want to move the cursor 
quickly to a specific word that you can see is (or is not) surrounded by 
blanks, The technique works less wellif you want to find the next occurrence 
of a word but don’t know where it happens to fall in a line. 


Notes on SEARCH 


Remember, SEARCH pays attention to case; if you search for “mary”, you. 


won't find “Mary” or “MARY”. You can use the character editing functions 
Of INSERT, DELETE, and LOCK while entering the SEARCH string, The 
SEARCH key is a function of the File System, Don’t assume that SUAKOH will 
perform similarly in other programs, 


you press}, | 
editing a line by pressing CLEAR before you leave the lin 
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When to Press CLEAR 


The editor does not store a new or modified line in the current file until 
+ or ENTER. Thus, you can undo any error you may make while 
e. The editor will 
return to the File System menu, and the changes you made to the last line 


will be discarded. Then you can reselect the same file and resume editing. 


Caution: When you have finished working ona file, you must leave the 
last line you edited before you press CLEAR. If you do not do so, the 
changes that you made in the line will not be preserved. Be cara bei 
to press CLEAR immediately after pressing ENTER, 4, or Pa ele L yh ‘ 
System needs time to store the updated line in the file. Waiting a secon 
or so is usually enough. | 


OTHER FILE OPERATIONS 


The File System provides three file operations in addition to editing text 
files: It lets you copy, rename, and delete files. 

The File System can perform these additio 
including a file containing a program that was no 
editor. (If you try to edit a program file, the File System 
the message “CAN’T EDIT”.) 


nal operations on any file, 
t created by the File System 
beeps and displays 


Copy a File 
Youcan copy a file with the COPY FILE option of the File System menu, 


: 7 b” file. 
Let’s try copying the “mary had a little lam | rite Shia 
Return to the File System menu and choose option 2, COPY FILE. he 
File System displays the instruction “SELECT FILE % followed by a menu 
of files you can copy. Unless you’ve done some experimenting on yourown, 


the only item on this menu is “mary had a little lamb”. 


[ 2=coPy FILE 


— 


| ienary hae a Little bart 
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select “mary had a little lamb” by choosing option 3 (or whichever option 
number represents the file in your menu). 

Now the File System displays the message “SELECT DESTINATION 
RAM”, followed by the one-item menu 


=H. 2223 FREE 


The phrase “INT RAM” means intrinsic RAM. This menu is part of a 
feature that lets you copy files back and forth between intrinsic RAM anda 
Programmable Memory Peripheral. For the moment, just press the | key; 
you'll learn how to use the menu in Chapter 6. 

After a moment, the File System displays the message “COPY DONE” 
and returns to the RAM menu. Notice that the menu now shows two files 
named “mary had a little lamb”. The first one is your original file, and the 
second one is the copy. 


Rename a File 


Now you have two files with the same name. If you modify one of them, 
how will you be able to tell which is which? You'll be able to tell them apart if 
you change the name of one of the files. 

To change the name of a file, edit the inverse image “line” containing the 
name of the file. Let’s do this. | 
| Choose one of the “mary” files from the File System menu—since they’re 
identical so far, it doesn’t matter which one. Wait for the File System to 
display the file name in inverse image, leaving the cursor at the end of the 
name, 

Now edit the file name to be whatever you want, using the INSERT, 
DELETE, and LOCK keys just as you would use them to edit a line in the file. 

| When you have finished, press | to make the File System save the edited 
file name. Then press CLEAR. Watch the file names on the File System menu; 
the file you chose now appears with its edited name. | 


Delete a File 


l'o delete a file, delete the entire line containing its name, For practice 

; . ’ 
let's delete the file you just renamed, 

| Choose the file from the File System menu, Wait for the Pile SVAlem Lo 

display the file name in inverse image, Now press DELETE L, The Pile Syatem 
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returns to the File System menu. Look at the file names on the menu; the file 
you chose is no longer there. 


Print a File 


Procedures for using HHC peripherals are discussed fully in Chapter 9, 
but printing a file is such a common operation that we'll describe it briefly 
Here 

There are two ways to print a file. You can use the HHC’s Micro Printer, 
Mini Printer, or Plotter. Or you can use a standard computer printer 
connected to the HHC’s RS-232C Interface. , 

If you are using an HHC printer or plotter, you need only load the device 
with paper and plug it into the HHC’s bus socket. If you are using a standard 
printer with the RS-232C Interface, you must also wire a cable to connect 
the Interface to the printer and match several configuration parameters on 
the Interface to those of the printer. Consult the instructions for the printer 
and the Interface’s device control capsule, or ask an experienced person or 
the dealer who sold the equipment to you for assistance. 

When you are ready to use the printer, observe the following procedures: 


Step 1. Connect the printer (via the RS-232C Interface, if any) to the 
HHC before selecting the File System from the main menu. Always 
turn the HHC off while connecting or disconnecting any peripheral, 

Step 2. Select the File System, then select the file from the File System 
menu. 

Step 3. Press the 1/O key. Now the HHC will display an 7/O menu, 
including an item similar to the following item: 


L=PRINTER OUT ,OFF ,SLOT=@ 


Pressing | selects the printer and changes the word “OFF” to “ON” in the 
menu. If you are using an RS-232C Interface, the HHC displays 


imRS-232C OUT,OFF ,SLOT=0 


A 
: 


emRS-2320 IN, OFF ,SLOT=@ 


Pressing } and 2seleciathe RS2IIC Interface and changes “OPP ta"ON”, 
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Press the 1/0 key again. This returns you to the File System. 

Press LOCK |, This causes the File System to display each file line from 
the first to the last. As each line is displayed, it is also printed. 

To interrupt the display and printout, press any key. If you don’t press a 
key, the File System displays and prints the entire file. 

To turn the printer off, press the I/O key, press the key for the menu 
number that corresponds to the printer, and press the I/O key again. 


FREE SPACE FOR FILE STORAGE 


To find out how much free space remains in intrinsic RAM, press the 1/0 
key. Again, you'll see the following I/O menu: 


[: 


This menu item says, “There are 2223 characters of free space in intrinsic 
RAM.” This free space can be used to add new files or to expand any of the 
files you have already created. Certain operating system functions also use 
this space. 

To resume what you were doing, press the 1/O key again. 





Ua. 2223 FREE 


The I/O Menu 


Unless an application program disables the I/O menu, you can look at it 
at any time. If you look at the I/O menu while you are running a program, 
the program will simply continue running—performing as though nothing 
has happened when you leave the I/O menu by pressing the I/O key a 
second time. While you are looking at the I/O menu, however, the program 
is “asleep.” This can be undesirable if, for example, your Telecomputing 
program should be watching a modem for incoming data. 

Most programs and peripheral devices take over some part of intrinsic 


RAM while they are running in order to hold internal data. Forexample, if - - 


you look at the [/O menu while a program is running, the amount of free 
room is reduced by whatever amount the program has taken, If you look at 
the 1/O menu while no program is running, expect the amount af free room 
to be somewhat larger, 
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When Free Space Is Exhausted 


When the free space in intrinsic RAM is exhausted, the HHC presents you 
with the message 


NO ROOM 


O 


r 
| OELETE F ZLES | 

You must delete some files from intrinsic RAM to free up enough room to 
continue your work. Press CLEAR to return to the primary menu and select 
the File System. Some programs display the “NO ROOM, DELETE 
FILES” message and then display files to select for deletion. (When the 
Programmable Memory Peripheral is plugged into the HHC, the DELETE 
FILE option does not always work, Chapter 6 describes this peripheral in 
detail.) 


FILE TYPES 


Every HHC file has a file type that is stored in RAM with the file but is 
invisible to you when you examine the file (for example, with the File 
System editor). | | | 

File type indicates file contents and determines what operations the HH 
will perform on the file. | | - 

A file created with the File System editor has the file type text. It consists 
of some number of lines, each of which may contain from 0 to 255 cha race 
ters. All text files can be edited by the File System editor. If you try to edit 
non-text files, the File System beeps and displays the message “CAN’l 
EDIT”. | | | 

HHC non-text files are binary files. One type of binary file, an execuiani 

SNAP file, contains a runnable SNAP program. Allexecutable SNAI files 
appear inthe secondary menu presented by the RUN SNAP PROGRAMS 





wleotlon from the primary menu (this is described fully in Chapter 7). 
Programs also use binary files to store “private” information, For example, 
the Telecomputing program series. which allows you to connect your HHC 
to ather computers through the modem, stores information in binary files 


uned for configuring the modems so that it can communicate with your 
vomputer, 


Other types of binary files you may encounter are 
' Microsoft BASIC program files 
snapBASIC program files 


SnapFORTH dictionary files (files produced from SNAP programs by 
the SnapFORTH compiler; they contain the compiled program plus 
additional information that is useful for debugging). 


In addition to its regular file type, any file may be invisible. An invisible 


file does not appear in the file menu presented by the File System editor (or 
In any other menu of files). Files that programs use to store “private” 
information are often invisible. For example, the files that the Tele- 


computing programs use to store their configuration parameters are 
invisible, 














The Calculator 


he Calculator program makes the HHC operate much hate 
a four-function pocket calculator because it computes sieenes 
elementary arithmetic functions and percentages and peat 
intermediate result. Certain HHC capsules provide much more ii bes 
calculating facilities than the HHC’s intrinsic calculator. These capsules i 
ter 7. : 

persona har, oO choose option | from the HHC’s primary oo 
On the LCD, the Calculator displays a blinking cursor over the number 0). 





THE KEYBOARD 


The Calculator Jets you use the keys in the top row to enter oe oe 
the keys in the second row to enter such operations as BaP an . i 
fourth row’s . key, shown in Figure 4-1! along with the first and secon 

ecimal point. 
igi ie = keys to produce the characters Q, W, E, R, and ae on 
also have distinct Calculator functions. On each one of these keys oe. 
symbol—from %, CM, RM, and Mt to =. You do not need to pee , 
2nd SFT key to type these characters into the Calculator. In fact, you shou 
not use the SHIFT or 2nd SFT keys with the Calculator at all. 


4 1 
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HAND HELD 
COMPUTER 


G=) SHIFT LOCK 2ndSFT DELETE INSERT ALARM ON LINE 


5 %I16 & “Hey (ys yang ra 
ol O 


STP/SPD OFF 
La 
—< pant eS 


2 INSERT | DELETE | LOCK 
fetclselSSstsl 

C2 C3 c4 ? SPACE 2nd SFT ENTER SHIFT 
Spee [Sol FSS] | 


Figure 4-1. Valid keys for the Calculator 


If you press a key that the Calculator does not use, the program will just 
beep. The Calculator will respond in the same manner if you press a valid 
key at the wrong time; for example, you'll hear a beep if you press + before 
entering a number. 


SIMPLE ARITHMETIC 


Press the four keys on the HHC’s keyboard required to display the 
following operation: 


As you enter “2 + 2,” the HHC displays the numbers and the + sign. The 
Calculator, you'll notice, displays both numbers and the + simultaneously. 
A pocket calculator, on the other hand, would display one number at a time. 
When pressed, = replaces “2+2” with “4”—the answer. 
The Calculator clears itself when you enter the first digit of a new number. 


If you want to clear the display, however, you can do so by pressing the. 


CLEAR Key once. 


Subtraction, multiplication, and division function like addition. Just — 


enter the appropriate sign between the two numbers you want to calculate, 
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At this point, you should try entering some arithmetic problems in order 
to become familiar with the Calculator. 


Correcting Errors 


Most pocket calculators provide only one way to correct a keying error: 
You must clear the number you are entering and enter it again. The HHC 
offers an easier way: Just press the ~ key. After the cursor moves left one 
space, you correct the mistake and proceed. 

You can press the ~ and — keys to correct errors buried within the 
information you have typed, just as you did while using the File System. The 
Calculator does not support the INSERT, DELETE, and LOCK keys, however, 

Unlike other Calculator operations, = acts on the entire contents of the 
LCD, no matter where the cursor happens to be. Suppose, for example, you 
enter the expression 


12.5+S.11 


But then you change your mind. What you really want to compute is 12.5 
50. Here’s what you do. Press + five times to get 


i2. S05..41 


Then press X,—, and 0 to get 


12.5xS@gk1 


Now, if you press =, the Calculator does not multiply 12.5 X 50, choosing to 
ignore the characters under and after the cursor; instead, it will multiply 12.5 
X 5011. To make the Calculator multiply 12.5 X 50, you must press . and 0 
to get 


12.5x5¢.088 


-and then press =. 
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Sequences of Operations 


To find the sum of a sequence of three or more numbers, type the first two 
numbers separated by a + sign. Enter, for example, 


and then press + again. The Calculator displays the sum of the two numbers 
you have entered and the second + sign, so that you get 


5+ 


When you enter the third number, the Calculator displays 


S+4il 


When you press + again, the Calculator displays the new sum and the next 
+ sign, so that you get 


3+ 


and so forth. Compute the final sum by pressing =. 
You can perform any sequence of operations the same way. Try entering 
the following sequence of operations: 


2+3x48 


In conventional arithmetic the result would be 14, because multiplication 
takes precedence over addition. In other words, you would get the follow- 
ing: 3X4=12 and 2+12=14. On the HHC, however, entering 


| et Ix | 


makes the Calculator display 
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and then entering 4 and = makes it display 


faa | 


The Calculator performs sequences of operations in strict left-to-right order 
because it performs each operation as soonas the two numbers are entered, 


Ranges and Rounding 


The Calculator can operate on numbers as long as ten digits. Internally, 
however, the Calculator stores numbers that are 13 digits long. Thus, you 
can perform long sequences of operations and be confident that your final 
result will be accurate to ten digits. 

When the Calculator displays a number that cannot be represented 
exactly in ten digits, it rounds the display up or down to the closest ten-digit 
number. If, for example, you multiply 


GPEC GGG SEC i 


the HHC’s internal 13-digit result is 109.9999999890. This amount rounds 
up to the ten-digit result 110.0000000, and displays 


11 


But subtract 109 from the product, and you will see 


{229799989 


Though it has not displayed them, the Calculator retained all 13 digits of the 
product and used them in the subtraction. 


Percentages 


The Calculator can also compute percentages. 
Suppose your company’s sales were $150,000 last year. If this year’s sales 
are 120% of last year’s, what will they be? To answer that question, enter 


L5@BIOX120% 


When you press %, the Calculator computes the result and displays 


182000 
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You would get the same result if you entered 


| L5O00@X1.20= | 


und that makes sense, because 120% of 150,000 is the same as 150,000 
1.20, 

The % key works the same way with division as with multiplication. For 
example, let’s reverse the multiplication problem. If your sales are $180,000 
this year and if they are 120% of last year’s sales, what were your sales last 
year? When you enter 


| LBOOGB+ 120% 


the Calculator displays 


(1 58000 | 


And you will arrive at that same correct answer when you enter 


| LHOOO8+1.20= | 


The % key works a little differently with addition and subtraction. It 
increases or decreases a quantity by a given percentage. This approach is 
equivalent to adding a percentage of the quantity to itself or subtracting a 
percentage of the quantity from itself and is useful for computing dis- 
counted or marked-up prices, sale price plus tax, and so forth. 

If, forexample, the sales tax rate is 6%, what is the price plus tax ona sale 
of $57,50? 

lo find the answer, enter 


| 57 .50+6% | 


and the Calculator will display the following answer: 


To take a 10% discount of $57.50, enter 


€ 1 5A 10% | 





i ii il ee 
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and the Calculator will display 


maled Zi 


MEMORY OPERATIONS 


In an area called memory, the Calculator stores an intermediate result 
while calculating the next operation. The HHC keyboard keys CM, RM, M+, 
and M- manipulate the Calculator’s memory. The Calculator’s memory is 
distinct from the HHC’s memory. 

The HHC’s memory (RAM and ROM) isall the area that stores the HHC 
programs and data. The Calculator’s memory is an area set aside to hold one 
number. 

To use the Calculator’s memory feature, you must remember the follow- 
ing simple rules: 


Rule 1: The M+ (add to memory) key adds the last number on the LCD to 
memory. The M- (subtract from memory) key subtracts the last number 
on the LCD from memory. Neither key affects the contents of the LCD. 


Rule 2: The RM (restore memory) key replaces the last number on the 
LCD with the contents of memory. This key does not affect the con- 
tents of memory. 


Rule 3: The CM (clear memory) key sets memory to zero. The CM key is 
the only thing that sets memory to zero. The Calculator “remembers” 
the value stored in memory when you turn the HHC off and back on; 
when you reset the Calculator by pressing the CLEAR key once; and 
even when you return to the primary menu and then reselect the 
Calculator. 


Let’s see how these rules apply in practice. 

Suppose you want to calculate the average speed of a car during a 
crosstown trip. At the start of the trip, the time is 10:18 and the car’s 
odometer reads 112.0 miles. At the end of the trip, the time is 10:45 and the 
odometer reads 125.5 miles. 

The average speed is equal to the distance traveled divided by the time 
clapsed, or 


125.5 — 112.0 
[0:45 — 10:18 
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iret, let’s compute the elapsed time. Since the hours are the same, we 
don't have to do any conversion of hours to minutes; we can just subtract 


45-1B8= 


to get the elapsed time, which is 27 (minutes). 

Before computing the distance traveled, clear memory by pressing the CM 
key, Now add the intermediate result to memory by pressing the M+ key. 
his operation stores 27, the intermediate result, in memory, 

Now you can compute the distance traveled by entering 


Lée.5-112.0= 


and you'll get 13.5 (miles). 
Finally, you'll have to divide 13.5 by the quantity in memory, which is the 


clapsed time. To do this, press the + key. Now press the RM (restore 
memory) key, and the LCD will display 


| 13.5427 | 


The Calculator has restored 27, the contents of memory, after the +. 


Now you can press = and get your result, which is 0.5 (0.5 miles/ minute, or 
30 miles/hour). | | 


Restore Memory 


Let s repeat the demonstration above but with one difference. Before 
pressing RM, you'll enter a second number. 
Press CLEAR once and then press the following keys: 





18=cmnm+ 125.5-112.0+6 ave 


In this case you might expect the Calculator to divide 13.5 (the difference 
between 125.5 and 112.0) by 627 (the 6 you pressed and the 27 restored by 
RM). Instead, it divides 13.5 by 27, just as the first demonstration did. The 


Calculator does this because the RM key replaces the last number of the - 


display line with the contents of memory. (Compare this with Rule 2 men- 
tioned earlier.) 


How does this rule apply to the first demonstration, where you pressed 
RM immediately after +? 
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After youentered +, the Calculator decided there was a number after the 
+ even though you had entered no numeric digits. Then the Calculator 
replaced that zero-digit “number” with the contents of memory. 

To demonstrate this principle again, press CLEAR and enter 


Now, instead of pressing the = key, press RM. The RM key replaces the last 
number on the display with the contents of memory, giving you 


Clear Memory 


In the average speed problem mentioned earlier, you cleared memory 
before adding the elapsed time to it. This was an essential step, even though 
you were using memory for the first time since selecting the Calculator from 
the primary menu. Remember, memory isn’t cleared when the display 1s 
cleared. The only way to clear memory is to press the CM key. 


Store a Constant 


When you are performing a series of simple calculations, you can use 
memory to hold a constant value. This saves you the trouble of entering the 
constant over and over. 

Suppose, for example, you want to converta list of volumes from gallons 
to liters. Since there are approximately 3.785306 liters ina gallon, you must 
divide liters by 3.785306 to perform each conversion. 

You can set up the Calculator for this conversion by storing in memory 


cm 3.785306 m+ CLEAR 





What is the gallon equivalent of 15 liters? To find the answer, enter 


The answer is 3.962691523 gallons. 
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CM 
co | = MEMORY 


CM stores zero in memory. 


What is the gallon equivalent of 22 liters? You should enter 


2erRm 


lo get the answer, 5.811947568 gallons. 
Each time you use the RM key in this calculation, you save seven key- 
strokes, You also reduce potential keying errors. 


Multiple Adds 


Youcan use the Calculator’s memory to accumulate the sum ofa series of 
intermediate calculations, 

Suppose, forexample, you want to calculate the area of an office contain- 
ing rectangular rooms that are 10 X 13 feet, 11 X 9 feet, 10 X 10.5 feet, and 
[2 X 21 feet. 

Clear memory, compute the area of the first room, and add the answer to 
memory. 


M-+r 





MEMORY 


MEMORY 





M- subtracts the last number on the LCD from memory. 


ch LOX 13=M+ 


LCD | MEMORY 


Compute the areas of the second, third, and fourth rooms and add the 


answers to memory. RM replaces the last number on the LCD with the contents of memory. 


LixS=m+ 
Figure 4-2. Rules gcverning the Calculator’s use of memory 
10X19. 5=m+ 


L2x2l=m+ 


Now restore the sum from memory with RM, and you have the result. 
Figure 4-2 summarizes the rules governing the Calculator’s memory 
operations. 


RETURN TO MAIN MENU 


To return from the Calculator to the primary menu, press the CLEAR key 
(wice in a row. Remember, one CLEAR returns the Calculator to its initial 
state (except that memory is not zeroed); two CLEA Rs return the HHC to the 
primary menu, 











The Clock/Controller 


: he Clock/Controller keeps time with a highly accurate 
internal clock even when the HHC is turned off. The Clock/ 
Controller lets you 

- Display the current date and time 

- Set the current date and time 


- Set an alarm that will “ring” at a specified time, even if your HHC 1s 
turned off 


» Review and acknowledge an alarm that is “ringing” 
- Review all the alarms that are currently set 
-.Cancel any alarm before it “rings.” 


You can use the Clock/Controller as an electronic datebook to keep 
track of all your appointments and tasks, friends’ birthdays, and other 
noteworthy events, 
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ENTER THE CLOCK/CONTROLLER 


To enter the Clock/ Controller, choose option 2 from the HHC’s primary 


tnenu. A secondary menu will display 


DATE AND TIME 


If your H HC is new, its internal clock-calendar probably has the wrong 
date and time. To set the current date and time, choose SET TIME option 
5, from the Clock/Controller’s menu. | 


The Clock/ Controller displays the date and time in the following format: 


SAT 10:17:16810716/92 


According to this display, the time is 17 minutes, 16 seconds after 10 in the 
morning, and the date js Saturday, October 16, 1982, 
lo change the date and time, enter corrections in the same format 


revising only the parts you want to change and using the — and — keys to 
skip over the correct parts. 





The cursor skips over such constant parts of the display as the eolons, 


in the time and the “M” in “AM” or “PM.” Since the Clock/ 
Controller automatically computes the correct day when you set the date 
(le cursor also skips over the day of week. | 


hind the telephone company’s “time of day” number or any other accu-: 


rate source forthe current time. Set the Clock/ Controller’s time of day afew 
seconds in the future, Wait until the actual time matches the time vou have 
net, and then press the ENTER key. At this point the Clock/ Controller sets its 
internal clock and returns to its menu, 
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As long as the HHC’s batteries are charged, the clock—once set—should 
gain or lose no more than a second per day. 
If you wish to return to the secondary menu without changing the date or 


lime, press CLEAR. 


Viewing the Time 


To view the current time, choose TIME, option 4, from the Clock/Con- 
troller’s menu. The Clock/ Controller displays the time in the following 


format: 


SAT 1:17 s1L6G, OCT 16 1962 


The Clock/ Controller increments the time, second by second, as you 


watch it. 
To return to the Clock/ Controller’s menu, press CLEAR. 


CLOCK/CONTROLLER ALARM SYSTEM 


To set a Clock/ Controller alarm, choose SET ALARM, option 1, from 
the Clock/Controller’s menu. The Clock/ Controller displays 


SET ALARM, TYPE ENTER 


and then displays the current date and time. 
Set the date and time when you want the alarm to “ring,” and then press 
ENTER. At this point the date and time disappear, and the Clock/ 


Controller displays 


MESSAGE: 


Now you can type a message as long as 26 characters. 

When you have finished typing your message, press ENTER again. The 
Clock / Controller plays a musical phrase, sets the alarm, and returns to the 
Clock/ Controller menu, 

If you wish to return to the Clock/ Controller menu without setting an 


Alarm, press CLEAR, 
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Reviewing Alarms 















To review the alarms that are set, choose REVIEW, option 2, from the 
Clock/Controller’s menu. The Clock/ Controller displays 


REVIEW, USE ARROWS 


and then displays the message associated with the most recently entered 
alarm, 
To see when this alarm will ring, press the — key. To see the messag 
again, press the — key. 
To see the message associated with the alarm set just before the moa 
recently entered alarm, press the ! key. To see the corresponding date anid 
time, press the — key. 
You can continue reviewing the alarms by pressing }. When you pass { 
last alarm in the HHC’s memory, the Clock/ Controller beeps instead 
displaying another alarm message. 
You can return to a more recently entered alarm at any time by pressin 
the tkey. When you reach the most recently entered alarm, pressing | apait 
makes the Clock/ Controller beep. Figure 5-1 summarizes cursor control fa 
reviewing and acknowledging alarms. 
To return to the Clock/Controller’s menu, press CLEAR. 


Deleting Alarms 


To delete an alarm before it starts “ringing,” display the alarm’s mennape 
or its date and time. After you press the DELETE key, the Cloek/ 
Controller displays the message 


DELETED 


und waits for you to press a key. 
Alter you press}, t, or CLEAR, the Clock/ Controller moves to the neat 
("1") or previous (“ft”) message or returns to the secondary menu (CLEA) 


When an Alarm Rings 


When an alarm “rings,” the Clock/Controller plays a short musical 
phrase-—even if another program is running or the HHC is turned off, Unt 
you acknowledge the alarm, the HAC will repeat the musical phrase abet 
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~ te 


rein, the “left arrow”, to move from an alarm message to its time. 


Cait a, Ist alarm’s message 


2fid alarm’s message 
3rd alarm’s message 





énd alarm’s time 
trad alarm’s time 


ress — , the “right arrow’ 


most recent time | ——- 7] 


2nd most recent time 
4rd most recent time 


’, to move from an alarm’s time to its message. 





2nd most recent message 
3rd most recent message 


to move from the first alarm time or message to the 


most recent message 


ress |, the “down arrow”, 
aecond alarm’s message. 


most recent time | 


| 2nd most recent time | 


4rd most recent time 





3rd most recent message 


Press t, the “up arrow”, to move from the second alarm’s time or message to the 
first alarm’s message. 


| most recent time | f | Be : 


[ 2nd most recent time | znd most recent time most recent time 





[ 2nd most recent message | most recent [ 2nd most recent message | 


4rd most recent ime 3rd most recent message 


Figure 6-1. Viewing alarm times and messages with cursor control keys 
(annotated flow chart) 
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every ten minutes and, when turned on, will display the ALARM blip on the 
LCD, 


Toacknowledge an alarm, choose ACKNOWLEDGE, option 3, from the 
Clock / Controller menu. The Clock/ Controller displays the message 


ACKNOWLEDGE, USE ARROWS 





li then displays the message associated with the most recently set alarm that 
is ringing. 

If more than one alarm is ringing, you can navigate among them with the 
arrow keys, just as you would inthe REVIEW option. When you're ready to 
acknowledge an alarm, follow the same procedure you used to delete an 
alarm with REVIEW—press DELETE and thent,!, or CLEAR. 

When two or more alarms are ringing, you must acknowledge all of them 
to stop the repetition of the musical phrase. Don’t think of the phrase as “an 
alarm.” Rather, consider it an indicator of “one or more alarms.” You won't 
know how manyare ringing until you review the alarms with ACK NOWLEDGE. 

You can also delete ringing alarms with the REVIEW option. The Clock/ 
Controller turns off the ALARM blip when you have deleted all ringing 
alarms. The ACKNOWLEDGE option is more convenient for this purpose, 
however, since it shows only the alarms that are ringing. 








Special-Purpose Keys 
And Memory Features 





and AUTO-OFF make the HHC easier to use and make the HHC a 

more efficient tool. The 1/0 key allows you to access peripherals. The 
fl, f2, and f3 keys define functions. And the keys labeled C1 through C4 are 
reserved for use by specific application programs. In Figure 6-1 these keys 
are highlighted on the keyboard. 

This chapter also builds on the knowledge you gained about memory a nd 
file manipulation while reading Chapter 3. The Programmable Memory 
Peripheral adds a new area of RAM to your HHC, and the persistent 
memory feature gives you stop-and-go computing capability, 


T’ his chapter describes several special-purpose keys. The HELP key 
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HAND HELD 
COMPUTER 


Figure 6-1. Special-purpose keys 


THE HELP KEY 


The HELP key reminds you of the functions of other keys on the keyboard. 


When you press HELP, the HHC displays the message 
(! Rl 55 KEY FOR DEFINITION 


Now press —, —, 1/O, or any other special-purpose key, and the HHC 
displays a brief message explaining the function of that key. 

[o get a short explanation of the INSERT key, for example, press HELP 
and then INSERT, and the HHC will display 


INSERT TEXT 


You can use the HELP key while you are running most HHC programs 
(Microsoft BASIC is one of the exceptions) or while you are using the HHC 
primary menu, However, HELP displays the same text message for each key 
no matter what program is running. Many programs use keys like INSERT 
and DELETE for distinet functions, and HELP does not reflect that {aet, 

You cannot use the HELP key while you are using the 1/0 key or the 
STP/SPD key, 
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THE I/O KEY 


Chapter 3 describes one application of the 1/0 key—determining how 
much free memory remains in intrinsic RAM. The 1/0 key has two other 
functions: It switches the HHC’s file space from intrinsic RAM to a Pro- 
grammable Memory Peripheral and back, and it turns peripheral devices on 
and off. These functions are discussed later in this chapter and in Chapter 7. 

You can use the 1/0 key while you are running most HHC programs, 
except Microsoft BASIC, or while you are using the HHC primary menu. 


THE STP/SPD KEY 


The STP/SPD suspends the HHC’s operation while you examine the 
contents of the LCD and controls the speed of the LCD display. 
To suspend the HHC’s operation while you examine the LCD, press 


' sTP/SPD. To resume the operation, press STP/SPD again. 


To control the speed of the LCD display, press STP/SPD and then a 
number key such as 1, 2, ..., 9, Or 0. At this point the HHC immediately 
displays information at a different rate. The “STP/SPD 1” combination 
produces the slowest display, “STP/SPD 9” the second fastest, and 
“STP/SPD 0” the fastest. 

Experiment with the STP/SPD Key to find a comfortable display speed. 

You can use STP/ SPD at any time. However, no processing can take place 
when the HHC is halted by STP/ SPD. Such a feature can cause problems. If, 
for example, you are running a Telecomputing program and another com- 
puter sends your halted HHC a message, the HHC won’t detect the mes- 
sage’s existence. —_— 

The display speed setting is not affected by the CLEAR key. Barring 
accidents—batteries running down, for example—the display speed should 
remain the same until you change it, or until you turn the HHC off with the 
ALL-OFF switch. 


THE AUTO-OFF FEATURE 


Whenever the HHC is on but not used for approximately ten minutes, the 
AUTO-OFF feature automatically turns off the HHC. 

The AUTO-OFF feature does not work when the STP/SPD key has stopped 
the HHC, when the I/O menu is being displayed, or when the HELP key has 
just been pressed, If left on in one of these states, the HHC will remain on 
until you turn it off of until the batteries run down, 
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THE FUNCTION KEYS 


bach function key represents a series of as many as 15 keystrokes. When- 
ever you press one of the function keys, the HHC will respond as if you had 
entered the series of keystrokes that the function key represents. 

Function key definitions are not erased by the CLEAR key. 


Define a Function Key 


To define a function key you have to perform the following steps: 


Step 1, Press the HELP key. At this point the HHC displays the message 
“PRESS KEY FOR DEFINITION”. 


Step 2, Press the function key you want to define. The HHC displays 
“DEFINE FUNCTION” and then the current definition (ifany) 
of the key. After the last character of the definition, the HHC 
leaves a cursor consisting of a nonblinking underscore. Although 


the definition may be 15 keystrokes long, only the first 14 will be 
displayed. 


Step 3. Enter the series of keystrokes this function key will represent. The 
keystrokes may include any key except ON, OFF, CLEAR, or 
another function key. It may, for example, include the ENTER 
key. The I/O, STP/SPD, and HELP keys do not perform their 
normal functions when they are part of a function definition. 
The HHC uses inverse-image characters to represent the special 
keys it can store ina function key definition. Shown in Table 6-! 


are the characters displayed when special keys are used in a 
function definition. 


After you enter the last character of the definition, press the function key 
again, Phe HHC will complete the function key definition and return to its 
previous task, You may also press CLEAR to complete the function key 
definition, 

If you enter a function key definition that is 15 characters long, the HHC 
Hashes the message “FULL” onthe LCD when you enter the 1 5th character. 
lhen it completes the function key definition and returns to its previous 
lask, 

Since a function key definition may include >, —, INSERT, or DELETE, 
you can't use those keys to edit a function definition. If you make a mistake 


while entering a definition, you must complete the function key definition 
anid then reenter it, 
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To demonstrate, let's define a function key that chooses the “o a 
from the primary menu, selects the first file (option 3) from the File systen 
1S st li he file. 
menu, and displays the last line of t | | ve 
To begin the definition, press HELP. At this point the HHC displays the 
message 





PRESS KEY FOR OEFINITION 
Press fl and the HHC displays the current definition of fl. If fl is unde- 


fined, the LCD displays only an underline cursor. 
Now press the keys 


Table 6-1. Special Keys and What They Display 


Symbol Displayed Key Symbol Displayed 


Oe|[o4]|04|[O+| 
08) '02 
io} (| ed bu Esl 











C1 
HELP 
eal Cc) 
ca 
1/0 
_ Co 
Cc 
C4 FA 
SEARCH | 
| = 
‘LOCK 
Cc 
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lhe funetion key is defi 

y 18 defined to simulate the kevstr 
1 hehe ystroke sequence 431.00 
The fl ends the definition. uence 3 Le 


Now, if you press ft while the H HC is displaying the primary menu 
* The first 3 selects the File System, 


WASIC or SnapBASIC; constant values for a calculator; or words that 
appear frequently in the File System editor. 


THE PROGRAM FUNCTION KEYS 


Ihe four program function keys are used in various ways by many 
application programs. Many applications let you use these keys to enter 
éommands when the main keyboard is being used for typing. When a 
Microsoft BASIC program is running, for example, the main keyboard 1s 
lined to type input data and the C1 key is used to interrupt execution of the 
program. Inthe COMMUNICATE mode ofa Telecomputing program, the 
main keyboard is used as a computer terminal and the four program 
function keys are used to enter control characters and perform other special 
luinctions. 

To the HHC’s hardware, the program function keys are just like main 
keyboard keys: They generate unique input codes that programs interpret in 
(istinct ways. When sent to the LCD, these codes display their repre- 
kentatives—all of the characters shown in Table 6-1. When sent to a periph- 
eral device that does not recognize the HHC’s extended character set—for 
example, a printer connected to the HHC through an RS-232C Interface— 
the codes produce unpredictable effects. (Peripherals are discussed in detail 


in Chapter 9.) 


* The second 3 selects the first file (option 3) fromthe File System's ment 
(the usefulness of the definition depends on whether or not this file 
always the one you want; since files are added to the end of the n ‘a 
your first file will remain in the first position). “- 


' LOCK, which is stored in the functi initi 
, win AR netion key definition as 
keystroke, is displayed as “M”. . 0 


‘ | moves the display down one line in the file, and the Sequence LOCK | 


moves the display to the end of the file. | it di} 
through the keyboard, , Just as if you entered it direetly 


Display a Function 


To display the definition of a functi 
To tion key, press HELP and then th 
funetion key, The LCD dis | i then 
mn key, plays “DEFINE FUN ” agai 
the definition of the function key ON on 
) When you have finished looking at the definition, press CLEAR. If you 
lave pressed no other keys since selecting the function you wanted lo 


display, the HHC will return to | 
af O 1tS previous ' 
function definition. p task without changing the 


Erase a Function 


THE PROGRAMMABLE 
MEMORY PERIPHERAL (PMP) 


A Programmable Memory Peripheral (PMP) is a device that contains 
4096 (4K), 8192 (8K), or 16,384 (16K) bytes of RAM to augment the HHC’s 
intrinsic RAM. Though not a true peripheral device—a program sees the 
PMP as an extension of the HHC’s memory—it is called a peripheral 
because it plugs into the HHC’s peripheral socket or 1/O Adaptor. 


| F, 0 _— a function key definition, press HELP and then press the ApPPras 
| rate unction key twice. You cannot erase a function key definition by 
Pressing HELP, the function key, and then CLEAR 


Use of Function Keys 


, eee use a function key at almost any time. The 33 LOCK | example 
nai oa to a al function key definition to select a program from the 
Mr len, se ect a program froma secondary menu, and then perform a 
repetitive Operation within the program, 

Use function keys whenever you need to enter the same sequence of 
keystrokes repeatedly because they “abbreviate” the sequence Be it to 
i single key, Por example, use function keys to store user canes 
passwords for Telecomputing; keywords for commands in Microsoft 


The Peripheral Plug Cap 


A plastic cap covers the peripheral plug to protect the PMP’s circuitry 
(rom damage by static electricity. The cap must remain on the plug when- 
ever the PMP is disconnected from the HHC. 

The PMP uses special low-power chips that are particularly sensitive to 
static electricity, 
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igure 6-2. PMP battery compartment 


The PMP'’s Batteries 


[he 4K and 8K PMP’s sliding back panel, shown in Figure 6-2, covers a 
compartment for three AAA size batteries. These PMPs do not need batter- 
los (0 Operate. When disconnected from the HHC, however, they need 
batteries to preserve their file storage. | 

You should equip your 4K or 8K PMP with “long life” alkaline batteries 
which last for about a year. When you insert the batteries in the battery 
compartment, be sure to orient them correctly, placing them as shown in 
Migure 6-2. 

To replace batteries without giving the PMP amnesia, connect it to your 
HC + The PMP will draw power from the HHC’s batteries while its own 
batteries are being changed. If you remove the PMP’s batteries while it is 
disconnected from the HHC, all of the PMP’s files will be lost. 

lo prevent the PM P’s bus plug from being disconnected or strained while 
you change the batteries, slide the HHC’s rigid plastic sleeve over the back of 
the HHC and the PMP, 

Ihe 16K PMP has built-in lithium batteries witha useful life of about four 
yeuts, When your PMP’s batteries near the end of their life span, take the 
entire PMP to an HHC service center to have the batteries replaced. 


Intrinsic and Extrinsic File Space 


When you connect a PMP to your HHC, you introduce an area of 
extrinsic RAM that is separate from the HHC's intrinsic RAM, 
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Whena PMP is connected, intrinsic RA M functions the same as before: It 
holds data used by the system and by a running application program and 
stores files. Extrinsic RAM may only be used to store files. 

At any time, the HHC has access to files stored in only one RAM area. 
Called the current file space, this area is eithes intrinsic RAM orina PMP’s 


extrinsic RAM. 
Using the 1/O menu, you can switch the current file space from one RAM 


area to another. 


Connecting the PMP 


Let’s go through the steps necessary to connect a PMP to your HHCand 


switch the current file space to the PMP. 

You cannot change the current file space while a program is running. If 
you try, the HHC will terminate your program and return to the primary 
menu. Always return to the primary menu before you plug ina PMP. 


Caution: Turn your HHC off before connecting or disconnecting a 2 


PMP or any other peripheral. This precaution eliminates any risk of a 


damaging the HHC or the peripheral. — 


Turn your HHC off and plug the PMP into the HHC’s peripheral socket. 
As you plug inthe PMP, the HHC beeps. When the beeping stops, the PMP 


plug is properly seated. 
Slide the plastic sleeve over the the back of the HHCand the PMP to hold 


them together and protect the peripheral plug from strain. 
Turn your HHC onagain. Now press the I/O key, and you'll see a display 


that resembles 






1=PRRNBRT 1665 FREE 


2=EXxT RAM, 16374 FREE ,SLOT=6 








This 1/0 menu is explained in the following statements: 


‘ The words “INT RAM”, displayed in inverse characters, identify the 
current file space as intrinsic RAM. Intrinsic RAM has 1665 characters 
of free space. 

+ “EXT RAM” (extrinsic RAM) tells you that one PMP is connected to 
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the HHC, Extrinsic RAM has 16,374 characters of free space, (This is 
di amount ol free space ina completely empty 16K PMP. A 4K or&8K 
PMP would show 4086 or 8182 characters—always ten characters less 
than the PMP’s total Capacity.) 


“SLOT = 0” means that the PMP is plu 
ed direct] : 
eral socket of the HHC, plugged directly into the periph 


To switch the current file space to the PMP, choose option 2 from the 1/0 
menu, and the HHC will display the message 


(EET . 16374 FREE, SLOT= 





@ 


Now the H HC will continue displaying the I/O menu, but this time “EXT 
RAM” Is displayed in inverse characters, which tells you the current file 
Space ts now located in the PMP’s extrinsic RAM. 

Press the 1/0 key again to return to the primary menu. 

You can only change the current file space when no program is running 
(or when you are willing to cancel the program that is running); but youcan 


use the 1/0 key at any time to check the amount of free space in each file 
space, extrinsic and intrinsic. 


Copying a File 


To copy a file from one file Space to another, switch to the file space you 
sen > copy “aie Enter the File System, select COPY FILE (option 2) 
rom the rile System menu, and then select the fil 
the COPY FILE menu. ee 


At this point the File System displays the message 


& LECT DESTINATION RAM | 


The Mile System will display a menu of the file spaces available to accept the 
copy ol the file, You can tell which file space is the current file space because 
its Hume 1s in inverse characters, Choose the file space that you want forthe 
duplicate file the File System creates. The File System then copies the file 
displays the message “COPY DONE”, and returns to the File System menu. 

If there is not Cnough room to create a copy of the file, the File System 


rete the message “NO ROOM, DELETE FILES” and does not make 
le COpy, 
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A Caution 


In the chapter on the File System, you discovered that many programs 
follow the message “NO ROOM, DELETE FILES” with a menu of files 
that you can delete. However, the DELETE FILES menu does not always 
work when you are using a PMP. The DELETE FILES menu only allows 
you to delete files from the current file space, that is, the PMP. In some cases 
the space shortage is located in intrinsic RAM, where a program—even a 
program stored in the PMP—must get space for its internal working stor- 
age. Youcan delete all the files in the PMP, yet fail to provide the space you 
need in intrinsic RAM. 

To solve this problem, first return to the primary menu. After using the 
{/O key to switch the current file space to intrinsic RAM and the File System 
to delete one or more files, switch the current file space back to the PMP and 
resume work, 


Other Uses 


Expanding your file storage is just one use for the PMP. Since it has its 
own batteries, the PMP can preserve a file when disconnected from the 
HHC. This feature makes the PMP a convenient medium for back-up 
storage. If you want to preserve a copy of a file, duplicate it onto a spare 
PMP and put the PMP ina safe place. 

The PMP is also aconvenient vehicle for transporting files. If you want to 
create a duplicate file on another HHC, you can copy the file ontoa PMP, 


- transport the PMP to the second HHC, and copy the file from the PMP to 


the second HHC. 

To create larger files than can fit inthe HHC’s intrinsic RAM, you should 
create files in a PMP since it has a larger storage capacity. 

Use a PMP to increase the amount of intrinsic RAM that a program can 
use as temporary storage. If you movea file from intrinsic RAM to extrinsic 
RAM, programs no longer have to compete with that file for working space 
in intrinsic RAM. 


THE PERSISTENT MEMORY FEATURE 


The HHC can recall what it was last doing even after you turn it off 
because of its persistent memory feature. 

Suppose, for example, you are using the Calculator. In the middle of a 
calculation, you turn the HHC off by pressing the OFF key. After a few 
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seconds (or days), you turn the HHC on again. Your partially entered 
enlculation reappears on the LCD. exactly as it was displayed before you 
turned olf the HHC. When you finish it, the calculation will be as correct ag 
if you had not turned off the HHC. | 
Turning the HHC off and on without losing information is not unique to 
the Calculator, Youcan do it with any program—intrinsic or not—that runs 
on the HHC. However, a program that uses a peripheral device sometimes 
reads or writes a spurious character when the HHC is turned off or on 
Peripherals are discussed in detail in Chapter 9, | 





Running Programs 


On the HHC 


uch of the HHC’s versatility arises from the wide range of 

programs available as separate products. This chapter explains 

how to run programs onthe HHC and surveys the programs that 
are currently available, but it does not describe each program in detail. You 
will find detailed information on specific programs in the manufacturer's 
documentation. 


HOW TO RUN HHC PROGRAMS 


The HHC runs programs in three basic forms—-HHC capsules, device 
capsules, and SNAP files. 


HHC Capsules 


An HHC capsule stores a program on a chip of read-only memory 
(ROM), The chip is mounted ona special plastic carrier that protects it from 
damage. 


Z1 
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Using an HHC Capsule 


lo install an HHC capsule, return your HHC to the primary menu and 
press the OFF key, Detach it from any peripherals. Now remove the panel 
on the back of the HHC. With the HHC capsule positioned so that the flat 
(ace is down, insert it into any one of the three sockets behind the panel, as 
shown in Figure 2-3. Now replace the panel. 

To use a program, turn the HHC on and watch the program appear as an 
additional item in the primary menu. If, for example, you have installed 
HHC capsules for the HHC programs Portaflex and Time/ Trac, you'll get 


( L= CALCULATOR _ 


=CLOCK“CONTROLLER 


jmF ILE SYSTEM 


RUN SNAP PROGRAMS 


[ 5 PORTAFLEX 
| 6 TIME/TRAC | 


Now press the key corresponding to the desired program’s menu number. 


Device Capsules 


A device capsule, which plugs into a socket in a peripheral device, pro- 
vides the HHC’s operating system with special software required to operate 
the peripheral. It may also contain an application program intended specifi- 
cally for use with the peripheral. One example, the Telecomputing 2 pro- 
gram, enables you to transfer files back and forth between a modem- 
equipped HHC and another computer. Telecomputing 2 is a device capsule 
that plugs into the modem. A modem is a peripheral device that can transmit 
dita from one computer to another over ordinary telephone lines. Chapter 
9, Using Peripherals, discusses modems in detail. 

Physically, a device capsule is the same asan HHC capsule. You can plug 
a device capsule into the back of the HHC or an HHC capsule into a device; 
no damage occurs, but they simply won't work. Figure 7-1 shows a device 
oapsule, 
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Figure 7-1. The Telecomputing | capsule 


Using a Device Capsule 


If the device capsule contains an application program, the program's 
name appears in the primary menu whenever the peripheral is connected to 
the HHC. You run a device capsule program the same way you run a 
program in an HHC capsule: Once connected, the program appears on the 
primary menu for your selection. Device capsule programs follow HHC 
capsule programs in the list. 


SNAP Files 


A SNAP file contains an executable program that you write in Snap- 
FORTH to perform a specific task. If your programs are generally used for a 
short time and then discarded, or if they are constantly used but require 


' frequent updating, they are good candidates for SNAP files. 


To create a SNAP file, write a computer program in the SNAP program- 
ming language and process it with the SnapFORTH compiler, which 1s 
available as an HHC capsule. A SNAP file is always written in SNAP but 
must be compiled in SnapFORTH. Chapter 8 clarifies this relationship and 
discusses compilers in detail. | 

You can also acquire a SNAP file by copying it from a second HHC using 
a Programmable Memory Peripheral. Use the File System to copy the 
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program into the PMP on the second HHC; then move the PMP to your 
HHC and use the File System to copy the program out of the PMP, as 
described in Chapter 6. You can transfer a SNAP file to your HHC directly 
from another HHC or some other computer, using the Telecomputing 2 
capsule and the HHC Modem. Telecomputing 2 is discussed later in this 
chapter, 

To run a program in a SNAP file, use the 1/0 key to select the file space 
that contains the file. Then go to the primary menu and select option 4, RUN 
SNAP PROGRAMS. The HHC now displays a secondary menu that 
includes all the SNAP files in the current file space. Simply select the file 
containing the program you want to run. 


SNAP Files and the File System 


SNAP files, as well as text files, appear in the File System’s menu. You can 
copy, delete, and rename SNAP files with the File System. However, if you 
iry toedita SNAP file, the File System displays the message “CANT EDIT” 
and returns to its menu. The File System doesn’t allow you to edit a SNAP 
file because the file contains non-text data. 


TYPES OF HHC PROGRAMS 


Most HHC programs can be divided by function into the following 
groups: calculating, data entry and editing, communicating, and language 
processing. | 

The Scientific Calculator, an example of a program that calculates, has 
log/exponential, trigonometric, and hyperbolic functions, and many other 
features of a multifunction scientific calculator. 

Portaflex is a program used to enter and edit data. It prompts you for 
information one field at a time, checking your responses for validity and 
consistency, and enters them into a customized file. 

Some programs let the HHC communicate with other computers. Tele- 
computing 2 lets you use the HHC as a terminal for communicating with 
another computer and allows you to transfer files back and forth between 
the other computer and the HHC. 

Programming language processors let you develop your own application 
programs or run programs that you obtain in human-readable source 
format from other HHC users, 

This chapter surveys the calculating, editing, and communicating 
programs, Chapter & surveys the language processors, 
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PROGRAMS FOR CALCULATING 


Scientific Calculator and Portabudget are calculating programs. 


Scientific Calculator 


The Scientific Calculator capsule gives the HHC calculating facilities 
comparable to a sophisticated scientific pocket calculator. It supports 41 
operations, including the standard arithmetic, trigonometric, and hyper- 
bolic functions, logs, powers and roots, and anormal distribution, random 
number generator. | 

The Scientific Calculator accepts input in reverse Polish notation (RPN), 
the form used by many scientific calculators. In reverse Polish notation you 
perform an operation by entering two numbers and then the operation. To 
multiply, for example, you enter 12 23 X instead of 12X23, Once you get 
used to this form of notation, you can use it to enter complicated expressions 
without the parentheses that ordinary notation would require. Figures 7-2 
and 7-3 show examples of RPN calculations. 

The Scientific Calculator has 12 locations for storing intermediate results. 


Scientific Calculator Functions 
In Other Programs 


A SNAP program can use many of the Scientific Calculator’s functions if 
the Scientific Calculator capsule is plugged into the HHC. The Scientific 


- Calculator capsule is then called a /ibrary capsule. In effect, the SNAP 


program can use the library capsule’s functions as though they were addi- 
tions to the HHC’s built-in numeric functions. 


















































505 ENTER enters 505 505 

3 enters 3 505, 3 

x multiplies 505 xX 3 1515 

384 ENTER enters 384 1515, 384 
enters 96 1515, 384, 96 
divides 384 + 96 1515, 4 

+ adds 1515 + 4 1519 


Figure 7-2. RPN;} Computing 505 X 3 + 384 + 96 
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You enter This happens Calculator contains 


505 ENTER enters 505 505 

9 enters 9 $05, 9 

+ adds 505 + 9 514 

505 ENTER enters 505 §14, 505 

3 enters 3 514, 505, 3 
i subtracts 505 — 3 514, 502 
x multiplies 514 502 258028 

II enters 11 258028, 11 
+ adds 258028 + I] 258039 

219 enters 219 258039, 219 
+ divides 258039 + 219 1178.260274 


Figure 7-3. RPN: Computing [(505 + 9) X (505—3) + 11] + 219 


Portabudget for Personal Budget Management 


The Portabudget program helps you manage your personal or family 
budget. It is currently under development and is expected to be released 
sometime in early 1983, 

Portabudget can keep track of activity in your checking, savings, and 
credit card accounts, and help you reconcile statements with your records at 
the end of each month. It can also keep track of your expenses in the various 
categories that you define, and can keep track of your total monthly 
expenses in each category so that you will know when your expenses have 
exceeded your budget. 


PROGRAMS FOR ENTERING 
AND EDITING DATA 


Portatlex and Time/ Trac let you enter and edit data. 


Portatlex for Customized Data Entry 


Portaflex is a program for interactive data entry, Although its specialized 
programming language creates data entry applications tailored to your 
apecific needs, you need not be a programmer to use Portatlex, 

Put your Portatlex application inte a text file, using the Pile Syatem, Then 





, 
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run Portaflex and identify the file that contains your application. You can 
keep several Portaflex applications in different files if you wish. 

Figure 7-4 shows a simple Portaflex program. 

Taking inventory in a warehouse, a typical Portaflex application, requires 
recording each inventory item in response to a series of prompts for stock 
number, quantity on hand, warehouse location, and so forth. The Portaflex 
program would accumulate this information for you in a text file, with one 
line representing each item. After completing the inventory, you could 
process the resulting file with another program onthe HHC or transfer it to 
another computer. 

A Portaflex application can perform several kinds of computations and 
check the data for validity and consistency. If a Portaflex application is 
supposed to prompt you for a state name abbreviation, the application 
could check your response for the correct standard abbreviation (NY for 
New York, IL for Illinois, and so on). If a stock number contains a fixed 
number of digits, a Portaflex application could check the number of digits 
you type and ask you to reenter the stock number if you typed too few. 


Time/ Trac for Time Accounting and Billing 


Time/ Trac, which records work activities for time billing, is designed for 
attorneys, accountants, consultants, and other professionals who bill by the 
hour. 

For each activity, Time/Trac can record start and stop times, client 
names, anda short descriptive comment. The accuracy of the start and stop 
times depends on the accuracy of the HHC’s internal clock. 

Time/ Trac records can be up-/oaded to a larger computer for further 
processing by a comprehensive billing system. With Time/Trac you can 
also review your activities and generate several kinds of printed reports with 
the HHC and a printer. 


PROGRAMS FOR COMMUNICATING 
WITH OTHER COMPUTERS 


Telecomputing | and Telecomputing 2 are device capsules for the 
Modem. Each capsule contains an application program that allows your 
Modem-equipped HHC to communicate with another computer, With 
these capsules, you ean use your HHC as a terminal to control another 
Computer, 
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*uantilty in stack. 

prompt Quantity in stack? 

PP rm he oC DOE EK KK KKK KUT 
Mumer ses 

query 

ave quantity 


*Lacation. 

prangst LocatLon? 
farmak «xe xx**KKMOXALIN 
alphas 

Munmar Les 

CjLiar \y 

save location 


‘Write data ltram to file & jump to collect next item. 
ie aa 
jump qelt-i1tem 





ligure 7-4. A simple Portaflex application 


Telecomputing 1 


lelecomputing | presents a menu with the options COMMUNICATE 
and CONFIGURE, 

COMMUNICATE lets your HHC communicate with another computer 
that has a modem, Anything you type into the HHC is transmitted through 
ith Modem and over the telephone to the other computer, Anything received 
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over the telephone by the HHC’s Modem is displayed on the LCD and ona 
Printer, TV Adaptor, or other attached output peripheral. 

The “review” feature of Telecomputing I’s COMMUNICATE mode lets 
you recall information that has scrolled off the LCD. Thus, on the 26- 
character LCD, you get to see more than the last 26 characters of your 
Telecomputing session. | 

CONFIGURE lets you set a number of options that control the way the 
Modem sends and receives data. To communicate with each other, two 
RS-232C devices—the HHC’s Modem and another computer—must be 
configured with matching options. 


Telecomputing 2 


Telecomputing 2 has all of the features of Telecomputing | except 
“review” and also lets you transfer files between the HHC’s File System and 
another computer. 

To transfer a file from the HHC to another computer, find, on the other 
computer, a program that will record typed data in a file. Most text editors 
will do the job. Then use the HHC as a terminal and start the program. 
Finally, command Telecomputing 2 to transmit the file. While Telecomput- 
ing 2 sends the data, the program on the other computer will record the file 
just as if you were typing information on the HHC’s keyboard. 

To transfer a file from another computer to the HHC, prepare 
Telecomputing 2 to receive a file. Then find, on the other computer, a 
program that will send and display the contents on the LCD. Telecomputing 
2 records the data while the other computer sends It. 

Telecomputing 2 has a special mode of operation that lets you transfer a 
binary file. For each byte in a binary file, Telecomputing 2 transmits two 
bytes. This feature enables the program to transfer all 256 values that a byte 
in a binary file may have while transmitting only the 100 or so printable 
characters that can be sent reliably over a modem. At the receiving end, you 
must set up Telecomputing 2 or an equivalent program to combine each pair 
of transmitted bytes into one file byte. 


Future Telecomputing Products 


A more advanced Telecomputing program is under development for 
release sometime in early 1983. 

As yet unnamed, this program will have all the important capabilities of 
Telecomputing 2, It will also detect any data errors that occur during 
transmission (because of a noisy telephone line, for example) and retransmit 
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the part of a file that contains the error. 

This new program will let you record a sequence of keystrokes in an auto 
file. You can then send the sequence to another computer on demand. If an 
auto file is divided into a series of messages, these messages may be sent one 
iit a time by pressing the ENTER key. Auto files are useful for logging ontoa 
line sharing system and other procedures that you must perform over and 
over, 

Because this new program will encode data ina special way so as to detect 
and correct transmission errors, you will need two versions. One program 
_ will run on the HHC and one will run on the other computer. 


RS-232C Capsule for Communications 


Phe RS-232C capsule is an HHC device capsule that lets you configure 
communications options and use the RS-232C Interface. The RS-232C lets 
you communicate with another computer over a data cable, much as Tele- 
computing | lets you communicate with another computer over the tele- 
phone system. | 

Capsules designed for the Modem may also be used in the RS-232C 
Interface, since the circuitry in the two devices is very similar. The future 
[elecomputing program capsule will be particularly useful in the RS-232C 
Interface, since it will allow you to perform error-free file transfers between 
two computers at higher data rates than the Modem can handle. 





Programming Languages 


For the HHC 


ommercially available programs can perform many different tasks. 
If you have a unique task that no existing program addresses, you 
may have to either write a new computer program or change an 
existing one to meet your needs. 
- Ifyou want to learn to write computer programs, this chapter will identify 
the programming languages that are available on the HHC and will tell 
which tasks each language is appropriate for. If you are not interested in 
learning to write programs, you may skip this chapter. : 


COMPUTER PROGRAMMING 


The computer and the nonprogrammable calculator have different 
functions. A calculator stores only the data that it uses in calculations. A 
computer,.on the other hand, stores the instructions that define the 


calculating process itself. These instructions are called a computer program. 
\ 


Machine Language 

The most straightforward way to create a computer program is to use the 
computer's own machine language to write the actual instructions that will 
be executed, 


61 
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lronically, the most straightforward way is also the most Lime-conwumtit 
and susceptible to error. Machine language is a difficult medium for people 
la use lo express computing processes. Although the instructions may be 
uite simple, using simple instructions to describe a process can be very 
tedious, 

Furthermore, since a machine language program is composed of numbers 
only, people find it difficult to read. Machine language instruction (hat 
perform addition might, for example, look like the following: 


es lLO@® 31141 2010@ 


Assembly Language 


| Assembly language, a form of notation for machine language inatrin 
Hons, $signs each instruction an alphabetic name, This name is easier for ie 
lo remember than the machine language series of numbers that repreant 
(he same instruction. 
An assembly language program section that adds two numbers and is 
= lo the preceding machine language example might appear as 
Ollows: 


LDA x 
Moo Y 
STA X 


To run assembly language programs, you need an assembler, This ik it 
program that translates a source program written in assembly language inte 
in object program written in machine language, allowing the computer Tr 
read the instructions. 


High-Level Languages 


A high-level language is a more sophisticated kind of programming taal 
It expresses instructions in a notation that is closer to English, 

he source program written in a high-level language is translated inte an 
Object program written in machine language by another program called a 
compller, A compiler performs the same basic function as an assembler, but 
the compiler is more sophisticated, since a high-level language differs move 
Irom machine language than assembly language, 

If you substitute a high-level language for the preceding nanembly 
language program you might get 
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Asarule, each kind of microcomputer has its own machine language and 
itv own assembly language, depending on the microprocessor used. But a 
high-level language is invented to solve a certain type of problem and is not 
necessarily tied to a single type of computer. The same high-level language 
program may be translated by compilers running on many types of 
computers. This capability gives high-level languages an additional 
advantage over assembly languages—they are portable. Portability is the 
lreedom to move programs from one computer type to another without 
rewriting them. 


Interpreters 


Some compilers do not directly translate a source program into machine 
language. They employ an extra step in the process, translating the 
instructions into a special internal language. This internal language may be 
considered the machine language of an imaginary pseudo-machine. A 
compiler can more easily translate a high-level language into this pseudo- 
tnachine language than into the actual machine language. 

When the pseudo-machine language program is run, an interpreter 
program examines and performs each pseudo-machine instruction as if the 
pseudo-machine were real. Called interpretive execution, this method of 
executing a program simplifies the task of a compiler program. Because one 
pseudo-machine language instruction may replace several machine lan- 
puage instructions, interpretive execution compacts the code and makes the 
program run more efficiently. 

Unfortunately, interpretive execution adds a step when running a 
program. Instead of being executed directly by the computer, each pseudo- 
machine instruction must be “executed” by the interpreter, which in turn is 
executed by the computer. Depending on the pseudo-machine language 
used, interpretive execution is anywhere from two to hundreds of times 


slower than direct machine execution. 


SnapFORTH 


SnapFORTH is a compiler and execution support package for the 
programming language SNAP. A variant of FORTH, SNAP is the most 
powerful and flexible language available on the HHC. It gives you full 
access to HHC operating system facilities such as file 1/O, peripheral I/O, 
and file space switching. Much of the HHC’s operating system and intrinsic 
application programs are written in SNAP. 
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inexperienced programmers; or that must be transportable to computers 
other than the HHC. 


“i eat : bre go ae N How to Use SnapFORTH 
dupr O< 'N BCNS®) = If you’re planning to write a lengthy SnapFORTH program, you should 
If drap 2 7 Deena can consider a host computer that has a full-size keyboard, a multi-line display, 
Sees . ) and disk storage. The host’s facilities make it much easier to develop large 

ELSE drop @ \ ELSE N too big; B=0 programs. 

ENDIF 3 When you write a program ona host computer, you must download the 


source code to the HHC (now called a target computer) through the 
RS-232C Interface (Figure 8-2). The SnapFORTH capsule on the HHC 
compiles the program and stores the object code ina file, just as if the source 
code were read from a file. | 

Once you have compiled a SnapFORTH program on the HHC, check it 
for errors or debug it by typing SNAP code onthe HHC keyboard. Each line 
of code that you type is executed as soon as you press ENTER. Youcan set up 
data for a program test, execute the program or any part of it, and study the 
results of the test. 

After running a series of tests, you can recompile part of your program 
und continue testing immediately. In other languages you would have to 
recompile the entire program from the start. 

When your program is complete, youcan make it intoa SNAP file, which 
you can then execute through the RUN SNAP PROGRAMS option on the 
HHC’s primary menu. 


(P If Nis a valid LCD character position, return N 4 Wee TRUE, 
flee return B=FALSE. ) 


Figure 8-1. A portion ofa SnapFORTH program 
















SNAP offers you most of the power normally associated With anke tt 
language programming, yet likea high-level language it relieves you att 
of the burdensome details of assembly language programming, y 

SNAP programs are compiled into an interpretive code, The SNAI | 
preter is built into the HHC’s operating system. More compact but slay 
than an equivalent program written in assembly language, a com 
SNAP program is more efficient than most high-level langunpes, 

The SnapFORTH compiler has a built-in assembler, sO YOU CAT W 
program partly in SNAP for ease of programming and partly in anne 
language for ultimate efficiency or fine program control, | 

Figure 8-1 shows a portion of a program written in SNAP, tn thin ee 
the shaded portion represents the actual source code; comments ate af 


unshaded type. 


Source Source 


program program Target 
Host RS$232C 
cobs FEBS FY Ga 


When to Use SNAP 


SNAP is an appropriate language for programs that are com 
more than several pages long; that must employ 1/O concurrently I 
peripherals, use library capsules, or make other heavy demand 
HHC%s features; or that must run as efficiently as pownitle, 

SNAP is inappropriate for programs that will be ined a few 
‘hen divearded; that must be developed rapidly, or developed at im 


\ 


Figure 8.2, Downloading a source program from a host computer 
to # target computer 
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MICROSOFT BASIC 


Microsoft BASIC, a product of Microsoft, Inc. of Bellevue, Washington, 


in a dialect of the programming language BASIC. The most widely used 
programming language on small computers, BASIC features simple syntax, 
n highly interactive nature that makes it easy to learn, and the ability to 
perform many kinds of tasks, including numeric computation and character 
processing. 

Since Microsoft BASIC is available on many computers, computer 
programs treating a variety of subjects have been developed in this dialect 
and can be run on the HHC with little modification. Most of these programs 
are part of the public domain or are available for a small charge ($5 to $50). 

Programs developed in Microsoft BASIC can be transported easily from 
the HHC to many other computers. Applesoft, one popular implementation 
of Microsoft BASIC, is distributed with Apple II and Apple II Plus 
computers. In fact, most application programs that run on the Apple IJ or 
Apple I] Plus are written in Applesoft BASIC and can be modified to run on 
the HHC, 

In addition, many books and courses of instruction for beginning 
programmers teach Microsoft BASIC as a first language. This minimizes 
(he difficulty you might encounter because of small differences between the 
HASIC you are using and the BASIC your book describes. 

The bibliography in Appendix F contains sources of BASIC programs 
(hat will run on the HHC with little modification. 

The version of Microsoft BASIC that is available on the HHC has several 
limitations. Only the first two characters of a program variable name are 
Kignificant; this means that the HHC’s Microsoft BASIC would treat the 
names PADS and PAID as though they represented the same variable. 
Since only the first two letters are significant, it is hard to assign 
ecaningful names to variables. You will find additional information onthe 
HHC Microsoft BASIC language in the manufacturer’s language manual. 

Muny of the HHC’s features are not accessible through Microsoft 
HASIC. Microsoft BASIC has no statements to read and write File System 
files, nor can it recover from execution errors such as reading a nonnumeric 

data item into a numeric variable. 

In summary, the HHC’s Microsoft BASIC is a very attractive language 
lor novice programmers but a poor tool for writing complex programs, 

Pigure 8-3 isa Microsoft BASIC program listing, This program prompts 
you fora date in “month, day, year” form—forexample, “feb, |,1974" and 
displays the day of year, February |, 1973, was the 32nd day of that year, an 
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110 PEM Convert a date ta day-of-year. , ; 
120 REM Inout: month, day, & year. G@ null month means “anc run. 
130 REM Qutout: day af year. 

140 REM Variables: MNS=menth of year [3 chars]. 
142 REM OM=—day of month. YR=year. 

150 PEM OF=cday of year, the result. 

170 .REM 

19@ REM MA= array of days in year before each month. 
185 FEM MOs(Ij=name of month Ii+1. 

19@ OIM MOS(12).MAC Le) 

200 FOR I=e@ TO ll 

210 READ MOS(1) MALT) 

220 NEXT I 

230 REM Promot user for month, day, year. 

34@ INPUT “Month,day, year” ;MNS,0M,‘R 

250 IF MNS=” “THEN END 

252 FOR I=e@ TO il 

254 IF MNS=MOS(1I)GOTO 258 

256 NEXT I t 
259 PRINT “Month name invalid!”:GOTO 240 

260 REM Calculate OR. 

238@ OR=MA(Ty+0M 

29@ REM Allow for leap years. 

300 IF I<=1 GOTO 350 

316 IF YR“400= =INT (4 ‘R400 }GBTO 34 

370 IF YR*‘L@O=INT(YR“1@@jGUTO 358 

330 IF YR“4<>3INT(YR“4)G0TO 350 

340 DR=ORT1 

PRINT “Day of year=”5DR 

GOTO 248 

CATA ”jan’,@,”feb”,31,”mar”,59 

® DATA “apr” ,30,”may”,120,” jun”,151 

4 DRTA “jul”,181,"aug ,212,"sep ,243 

4 DATA “oct”, 273,”nav” , 304 ,"dec” , 334 


OJ 
Ln 
> 


LO LJ WY vi ot 
Wm MW mM 
& 2 © © & 


ai. 
= 
— 


Figure 8-3. A simple Microsoft BASIC program 


“32” 1s the output. [The peoetem allows for the fact that February has 29 days 
in leap years. 


When to Use Microsoft BASIC 


Microsoft BASIC is an appropriate language for programs that are 
simple and small; that are used by a limited number of people; that must be 
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developed rapidly or by inexperienced programmers; that have already been 
written in Microsoft BASIC on some other computer; or that must be 
transportable to computers other than the HHC. 

Microsoft BASIC is a good language for programs that do a lot of 
lloating-point arithmetic with a preference for speed over precision. 
SnapBASIC uses the HHC’s intrinsic arithmetic routines that are accurate 
to 143 decimal places, while Microsoft BASIC uses its own routines that are 
wecurate to only 9 places. Microsoft BASIC’s less precise routines run 
luster, and this can make its programs faster overall if they do a lot of 
arithmetic, 

. Microsoft BASIC tends to be inappropriate for programs that are 


complex, longer than a few pages, or that make heavy use of the HHC’s 
lentures, 





How to Use Microsoft BASIC 


You enter a Microsoft BASIC program througha special program editor 
built into the Microsoft BASIC capsule. This editor converts the program 
into Microsoft BASIC’s interpretive code and stores the code ina file. You 
eun examine a Microsoft BASIC program with the Microsoft BASIC 
editor, but not with the File System editor. 

You run a Microsoft BASIC program by running Microsoft BASIC, 
selecting the file containing your program from a menu, and entering the 
Microsoft BASIC command RUN, 


SnapBASIC INTERPRETER/COMPILER 


snapBASIC is another dialect of the BASIC programming language. 
Like SnapFORTH, the SnapBASIC capsule compiles a BASIC program to 
an internal code, Thus, SnapBASIC programs tend to be compact and to 
run fast, although they are generally not quite so compact or fast as 
proprams written in SNAP. 

Hecause it is a dialect of BASIC, SnapBASIC allows you to debug 
programs ina highly interactive manner. Its combination of fast, compiled 
code and interactive debugging is unique among microcomputer BASICs. 

In Figure 8-4 an example of a short program written in SnapBASIC 
demonstrates several attributes of good programming style. The ONERR 
stalement on line 250 and the ONERR routine beginning on line 700 handle 
4 nonnumeric response to the “ZIP code” prompt, trapping errara before 
they cause the program to fail, Line 260 determines how much free memory 


a a ere 
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11@ REM ZIP code pecording program. 
26 PEM Inputs first, mame for a file to store ZIP codes in. 
13@ REM Than, each city, state, & code. 
140 PEM Output: data is stored in file. 
15@ PEM Variables: fnameto—filename: cityf=ocity name; statedostate; 
16@ REM zip=ZIP code; stlist$=valid states: errcodeSmerror code. 
17@ REM ; 
200 stlistS = “AL Al AR AZ CR CO DE DC FL GA HA ID JIL IN TH KA 
710 stlist’ = stlistS + “KY LA ME MD MA MT PN MS MO MT NB NV NH ” 
220 stlistS = stlist$ + “NJ NM NY NC NO OH Ok OR PA RI SC SD TN” 
230 stlist® = stliet$ + “TX UT VT VA WA WY WO WY” 
240 REM Set up error recovery & 1000 bytes free space for file. 
25M ONERR GOTO 7a 
260 zip=free[ free(@)-1000) 
30Q FEM Get file nave & create file. 
310 INFUT “Enter storage file name: “, frames 
J20 IF exist(fnames) THEN PRINT “Already exists!” : GOTO 310 
33@ FOPEN fnanes 
4aa REM 
418 PEM Take & record next input. 
420 INPUT “Enter city name: “,citys 
430 INPUT “Enter state code: “,statet 
440 IF lenfetate®) <> 2 THEN GOTO 500 
45@ IF search{stlist#,statett” ”,1jy=0 THEN GOTO 500 
46@ INPUT “Enter ZIP code: “,zip 
470 IF zin < 1@@@1 OF zip > 39999 THEN GOTO 680 
49@ FINS frec(@), city$t”.”“+tstatett+” ."“+lefts( stré(zip), 5 ) 
4350 GOTO 4ae 
500 REM 
510 REM Error, invalid state. 
S2@ PRINT “Invalid state code!” : GOTO 430 
6BaA REM 
616 REM Errer, invalid éIP code. 
620 PRINT “Invalid ZIP code!” : GOTO 46a 
Paw REM 
P1l@ REM ONERF recovery point. 
720 errcodet = chrS(peek(852)) + chrS({peek(S53) ) 
23@ IF errcaodet = “TM” GOTO e2h 
740 PRINT errcodes + ” error!” 
Poe aur 


Figure 8-4. A simple SnapBASIC program 


SnapBASIC has appropriated and instructs it to keep all but 1000 bytes, 
which are returned to the File System to give it space to create the output file, 
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When a snapBASIC program starts running, it appropriates most of the 
free memory in the current file space for its own use. 
EXIST( c in line 320 determines whether the file name given by the user 

id (he name of an existing file. “SEARCH” in line 450 checks the validity of 
the state name abbreviation. 

Capitalization and spacing enhance the program’s readability. This 
sample program will be stored ina File System file; if it were stored in a 
SnipBASIC file, the capitalization and spacing would be lost. 


SnapBASIC and Microsoft 
_BASIC Compared 


With its ability to read and write RAM files and to recover from errors 
snapBASIC is a more powerful language than Microsoft BASIC, In 
addition, SnapBASIC has more extensive facilities for peripheral I/O and 
possesses several major features that Microsoft BASIC lacks. 

With SnapBASIC you can store a source program in a File System file. 
lo compile the program, you enter the LOAD command with the name of 
the file containing the program. You can edit a program with the HHC File 
System editor or with SnapBASIC’s built-in editor. 

With SnapBASIC you can store and edit SnapBASIC programs on a 
separate host computer and download them to the HHC. 

Snap BASIC produces compiled SNAP code, which makes a SnapBASIC 
program faster and more compact than an equivalent Microsoft BASIC 
program. 

SnapBASIC has an integer arithmetic facility. Since integer arithmetic is 
much laster than floating-point arithmetic, SnapBASIC is much faster than 
Microsoft BASIC for integer calculations. Without an integer facility 
Microsoft BASIC must use its slower floating-point routines for all 
calculations, 

snapBASIC Supports many additional built-in functions, including 
numeric functions LN, SIN, COS, and TAN, integer functions ABS% 
MAX%, and MIN%, and bitwise logical operations functions BAND 
(and), BOR (or), and BXOR (exclusive or). 

SnapBASIC supports DATES, TIME$, SEARCH, STRF$, and string 
functions that convert a numeric value to a string with extensive control 
over the way the value is formatted. 

In SnapBASIC you can use variable names as long as will fit on @ source 
file line, Microsoft BASIC allows you lo write long variable names, bul uses 
only the first two letters of a variable name. | 
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A SnapBASIC program can read and write text or binary File System 
files. With SnapBASIC’s ONERR command, you can write a program that 
recovers automatically from an error such as nonnumeric input into a 
numeric variable. 


When to Use SnapBASIC 


SnapBASIC is an appropriate language for programs that must be 
developed rapidly or modified by inexperienced programmers, or that do 
not require heavy use of the HHC’s features. 

SnapBASIC is an inappropriate language for programs that require 
heavy use of the HHC’s features or that must be as efficient as possible. 


How to Use SnapBASIC 


Like SnapFORTH, SnapBASIC can compile a source program that is 
stored in a File System file or is downloaded from a host computer. 

Instead of converting your program into a special interpretive code, 
SnapBASIC compiles the program into SNAP code. Furthermore, 
SnapBASIC preserves your comments as well as information about 
variable names and line numbers so that the compiled program can be 
translated to its original form when you list or edit it. 

Both the compiled SNAP code and the other preserved information are 
stored ina SnapBASIC program file. You can list and edit this file only with 
the SnapBASIC editor, not the File System editor or Microsoft BASIC, To 
run the program, run SnapBASIC, select the SnapBASIC file that contains 
the program, and enter the command RUN. 

With SnapBASIC you can inspect and change the values of variables by 
typing BASIC commands on the HHC keyboard and then executing all or 
part of your program. This sequence lets you debug the program inter- 
actively. 

SnapBASIC’s ability to compile a program that is downloaded from a 
host computer is a great convenience if your program is more than a few 
pages long. If, on the other hand, you use the SnapBASIC editor to modify 
your program while you debug it, you will have to upload or duplicate the 
changes to the host system before downloading the program for additional! 

work ) 
| / 


Summary : 
! . 
Each of the HHC’s three programming languages is best suited for cer-* 
tain applications, You will have to decide which language to use for each 
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Table 8-1. HHC Programming Languages 
Characteristic oe Microsoft 
° ae BASIC SnapBASIC 
Access to File System 
Runelime error recovery 


HTC operating system 
features accessible to 
i program 


. . 
Programmer experience much much little 

needed for effective use os 
Luse of use for experie 

nced poor mod 
erate 

programmer Bote sil 
Sullubility for large 
; rge very poor ood 

oor 

complex programs : ° ere 
xeccution efficiency very high high very low moderate 
Programs can be plac 

WINS C placed yes 
yes no yes 


in HHC capsules 


Programs can be yes 
pluced in SNAP files 


yes 


application ona case-by-case basis. Table 8-1 summarizes the characteristics 
ol the HHC’s three programming languages. 


PROGRAM DEVELOPMENT 
FOR THE HHC 


I his section provides information on ROM chip types and sophisticated 


program development. If you are working only in Microsoft BASIC, you 
may wish to skip this section. | 


Types of Program Capsules 


several ot ths HHC language processors can produce object programs 
aston lor burning into HHC capsules. To produce programs that may 
T used in capsule form, you should know about the two types of ROMs 
used in HHC capsules, | | 


‘ H s] ‘ +7 .] iia ; ad ‘ 
A ROM chip's appropriateness for a given program dependa on ihe 
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number of program copies you expect to produce, not the function ol the 
program or the programming language used. Most HHC capsules come on 
masked ROM chips. This type of ROM is mass-produced with a built-in 
program and is suitable for production runs of a f¢w hundred capsules or 
more. Small-volume and custom programs developed by HHC distributors 
come on erasable programmable ROM (EPROM) chips. When purchased 
from HHC distributors, these chips are blanks premounted on capsule 
carriers. 

A program can be “burned” into EPROM chips, one or a few ata time, 
withan EPROM Burner. The EPROM Burner is a computer peripheral that 
records HHC programs on EPROM chips. EPROM Burners are available 
for many kinds of host computers. Since some burners are made with 
RS-232C interfaces, you can use them on a variety of computers, including 
the HHC itself. 

ROM capsules are manufactured in 2K, 4K, 8K, and 16K byte sizes. 
Although 16K bytes is the largest size capsule the HHC can accommodate, 
EPROM capsules are manufactured only in 2K and 4K byte sizes. 

Table 8-2 shows the characteristics of the two types of ROM chips. 


The HHC System Development Tools 


HHC distributors offer a development system called the HHC System 
Development Tools (HHC/ SDT) for HHC programs. HHC/SDT runs on 
the Apple I] computer and offers several major tools for developing 
program products, including a complete FORTH-based operating system, 
a SNAP compiler that runs on the Apple and produces object code for 
execution on the HHC, and an HHC simulator that runs on the Apple and 
permits you to test SNAP code. The simulator includes a SNAP interprete! 


Table 8-2. Characteristics of ROM chip types 


Burned during manufacturing process yes 





EPROM 








no 









Created on EPROM Burner no yes 


$10,000 4 


Per-program setup cost none 






relatively high = § 






Per-capsule cost relatively low 





Feonoemic production fun thousands up to hundreds 
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sO you can lest and debug programs with the Apple’s full-size keyboard, 

HHC/SDT also has a utility for making HHC EPROMs with an 
PROM burner card plugged into the Apple; utilities for downloading 
source programs or compiled programs from the Apple to the HHC and 
uploading them from the HHC to the Apple; and a screen-oriented text 
editor that can be used for SNAP program development and word 
processing. The word-processing function is essential for writing docu- 
mentation, 

Finally, HHC/SDT has a utility that makes the Apple function like a 

“dumb terminal” when connected to the HHC’s RS-232C Interface. Many 
HAC programs, including SnapFORTH and SnapBASIC, allow you to 
use a “dumb terminal” as a full-size keyboard and multi-line display in 
place of the HHC’s keyboard and LCD. 

Though not essential for developing application programs in SNAP, 
HHC/SDT makes a useful adjunct to SnapFORTH, especially if you 
already plan to do your source code editing on an Apple. HHC/SDT 
enables you to test most functions of your programs with the Apple’s 
full-size keyboard while running under the HHC simulator, and it offers 
you a number of utility programs that are useful for HHC program 
development. 


Products for Developers 


In addition to the HHC System Development Tools, HHC distributors 
sell several products that are useful to software and hardware developers. 

If you have an EPROM burner designed for a host computer, you can 
purchase an adaptor for burning HHC EPROMs. HHC distributors sell 
blank EPROM chips premounted on HHC capsule carriers, 

An HHC EPROM Burner peripheral, currently under development, will 
be a convenient tool for making EPROMs on the HHC. Watch tor 
announcements of this peripheral’s commercial availability. 

Contact your HHC dealer or distributor for more information about 
these products. 


- 


Using Peripherals 


eripheral devices expand the capabilities of the HHC immensely, 
enabling it to read input from sources other than the keyboard and 
write output to destinations other than the LCD. 

In this chapter you will learn about the various HHC peripherals that are 
available and the applications for which they are suited. You will also learn 
procedures that will help you use the peripherals. 

All the information that you will need to use any peripheral with prewrit» 
ten software is covered in this chapter. If you want to learn to write 
programs that exercise a peripheral’s special features, however, you must 
also consult the HHC owner’s manual or the literature that comes with the 
peripheral. 

You may also use this chapter to evaluate peripherals that you are 
considering purchasing. 

Peripheral devices are divided into three categories: those that read data | 
(input peripherals), those that write data (output peripherals), and those 
that read and write data (input/output peripherals). Included in the latter 
category are the Programmable Memory Peripheral (PMP), the RSe232C 
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Interface, Modems, and the 1/O Adaptor. Examples of output peripherals 
ure the Four-Color Plotter, Mini Printer, Micro Printer, and TV Adaptor. 
No current HHC devices serve strictly as input peripherals. 

[he first section of this chapter presents information common to all the 
HHC peripherals, using the Mini Printer as a specific example. The second 
section describes each individual peripheral in detail. After reading the first 
section you should read the second section to learn about the peripherals 
you own or those you wish to preview. 


Connecting a Peripheral 


To connect a peripheral to the HHC follow the same procedure used to 
connect the Programmable Memory Peripheral (PMP). First, turn off your 
IIH, This precaution eliminates any risk of damaging the electronic com- 
ponents in the HHC or the peripheral. 

Now plug the peripheral into your HHC’s peripheral socket. As you 
connect the peripheral, the HHC beeps. When the beeping stops, the periph- 
eral plug is properly seated. 

If you plan to move the HHC and peripheral while they are connected, use 
the HHC’s rigid plastic sleeve to hold them together. 

hinally, turn your HHC on again. If you forget to return the HHC to the 
primary menu before attaching the peripheral, the HHC’s operating system, 
operating as if you had pressed the CLEAR key twice, automatically returns 
to the primary menu. 

Now press the 1/0 key, and the I/O menu will tell you what devices are 
available, Each device configuration presents a unique menu. If an RS-232C 
Interface, Modem, and Mini Printer are attached, your I/O menu will look 
like this, 


( RS232C,1IN,ON,SLOT=3 | 


E P52392C ,0UT,ON, SLOT=3 


| le MODEM IN, OFF ,SLOT=4 | 








deMODEM OUT OFF ,SLOT=4 


[SePRINTER QUT,OFF,SLOT=5 | 
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To turn the Mini Printer on, press the key corresponding to the Mini 
Printer’s number—in this case, 5—onthe1/O menu. At this point the HHC 
displays 





PRINTER OUT ,ON,SLOT=5 





Now that the peripheral is turned on, the HHC resumes displaying the I/O 
menu. 

To return to the primary menu, press the I/O key again. 

Once a peripheral is on, pressing CLEAR will not turn it off. You must turn 
it off with the I/O key by disconnecting it from the HHC or connecting 
another peripheral. 

Application programs as well as the I/O menu can turn on peripherals, 
When you run them, some application programs turn on peripherals 
automatically. 

While displaying the I/O menu, the HHC cannot execute the program (if 
any) that was running when you pressed the I/O key. As a result, peripheral 
input intended for that program may be lost. Most peripherals can save, or 
buffer, incoming characters until you leave the I/O menu, but their buffers 
ing capacity is usually limited to no more than ten characters. 

The I/O menu displays the key that must be pressed to turn on each 
peripheral and displays each peripheral’s status. For example, 





describes the status of the Mini Printer. According to this 1/O menu, the 
Mini Printer is an output device, is currently turned on, and is plugged 
directly into the HHC’s peripheral, or zero, socket. 

For the peripheral capable of input as well as output, the 1/O menu 
contains two items—one labeled “OUT” and one labeled “IN.” Because the 
HHC treats an input/output peripheral as two separate devices—one [o1 
input and one for output—you should turn on both “devices” when you 
want to use an input/output peripheral. 

When a peripheral is turned on, it uses a few dozen bytes of the free space 
in internal RAM, If you want to calculate the exact amount, note the 
amount of free space that the 1/O menu shows in internal RAM before and 
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after you turn on the peripheral. Once this space is taken, the space remains 
tied up until the device is turned off and the HHC is returned to the primary 
menu, Simply turning the device off again will not free the space. 

Some programs, including Microsoft BASIC, disable the I/O key. Before 
running such a program, you must turn on all the peripherals that you need. 


Peripherals as Slaves 


[he File System editor from the HHC’s primary menu demonstrates the 
use Of an Output peripheral. 

The File System editor automatically writes to any output device con- 
nected to the HHC and turned on with the 1/0 key. Whatever the File 
System displays on the LCD, it also writes to the peripheral. In other words, 
the File System s/aves the peripheral to the LCD. 

Select the File System from the primary menu. As soon as the program 
a{urts running, output appears on the peripheral. 

To turn a peripheral off while running a program, invoke the I/O menu by 
pressing the I/O key and then press the key corresponding to the peripheral’s 
menu entry, At this point the HHC will display a message like 


PRINTER OUT OFF ,SLOT=@ 





and then display the I/O menu. If you press the I/O key again, the HHC 
returns to the File System. But since the peripheral is turned off, it is not 
slaved to the LCD output. 

Practice turning the peripheral on and off again with the 1/0 key. When- 
ever (he peripheral is on, it is slaved to the File System’s LCD output. Some 
peripherals generate a spurious output character when you turn them off 
with the [/O menu or when you turn the HHC off with the OFF key. 

Not all HHC programs simply slave peripherals to the LCD. Since many 
programs use peripherals for other functions, you may have to enter special 
commands to operate them. 


Disconnecting a Peripheral 


Turn your HHC off before you disconnect a peripheral, just as you would 
before connecting one. When you disconnect a peripheral, the HHC operat- 
ing system displays the primary menu and turns off any peripherals that are 
still attached, Use the 1/0 key to turn the remaining peripherals on again if 
you wish to use them, 
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Using Peripherals on Battery Power 


Many of the HHC peripherals drain substantial power from the HHC's 
batteries. The TV Adaptor draws so much power that you cannot run it on 
batteries at all. If you are using a peripheral for any extended period of time, 
use it with an AC Adaptor. 

Some HHC peripherals have built-in rechargeable batteries similar to 
those in the HHC main unit. These peripherals can run off one charge of 
their batteries for a few hours. 

Recharge a peripheral’s batteries by attaching the peripheral to the HHC 
and the HHC to an AC Adaptor. The batteries will recharge more slowly 
while the HHC is turned on than while it is turned off. 

All the instructions you read in Chapter 2 about the HHC’s batteries 
apply as well to rechargeable batteries in peripherals. 


THE I/O ADAPTOR 


The I/O Adaptor is an extension to the HHC’s peripheral socket, Not 
strictly a peripheral, it lets you connect several peripherals to your HH at 
once. 

The I/O Adaptor, shown in Figure 9-1, is a plastic tray with three long 
slots on the right side and three short slots on the left side. The lowest 
right-hand slot has a plug that fits into the HHC’s peripheral socket, 
Peripherals use the other five slots. A sixth peripheral socket is mounted on 
top of the I/O Adaptor. 

The left side of the I/O Adaptor’s tray is attached to the rest of the 
Adaptor by two spring-loaded clips. If you do not need the sockets on the 
left side of the tray, you can detach it. Once the tray is detached, the 1/0 
Adaptor is somewhat smaller and easier to handle. 

To use the I/O Adaptor, slide the HHC all the way into the lower right 
slot. Your HHC beeps while you do this, but the beeping stops when the 
HHC is properly seated. 

Although youcan plug any peripheral device into any socket, for the sake 
of convenience plug only long peripherals such as the Modem into the long 
slots. The top, sixth socket is reserved for future peripherals that cannot ft 
in the I/O Adaptor’s tray. To avoid damaging a peripheral or the 1/0 
Adaptor, use this socket only with an I/O bus cable like the one shown in 
Figure 9-2, 

When you use the 1/0 key with the HHC, a Printer, a PMP, the RSe2d2€ 
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Use the I/O menu just as you do when you plug a peripheral direetly inte 
the HHC—in other words, select a menu item representing a peripheral to 
turn that peripheral on or off. If you want to select a menu item representing 
a Programmable Memory Peripheral (PMP) to switch that PMP into the 
current file space, select item 7. A PMP represents extrinsic RAM, din 
played as “EXT RAM" in the menu. If you want to choose intrinsie HH 
RAM, you would choose item §, 

The “SLOT=x”" at the end of each I/O menu entry identifies the 1/0 
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howing the HHC socket 





ious a, The 1/0 Adaptor peripheral, s 
Be and six peripheral sockets 


Interface, and a Modem mounted in the I/ O Adaptor, the [/O ene shows 


the following list: 





l=PRINTER OUT OFF, SLOT=3 








SeRS2320,IN,ON,SLOT=4 





je RS232C,0UT,ON,SLOT=4 





Figure 9:4, The hie cable that in used to connect a peripheral 
le The alath peripheral socket on the 1/O Adaptor 
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socket into which each peripheral! 1s plugged. 
adhesive tabs next to your I/O Adaptor’s 
other. The slot numbers increase 


here the first slot 1s l. 


Adaptor slot or 

You may want to stick small 
eockets to distinguish one slot from an 
counter-clockwise from the lower left, w 


PRINTING AND PLOTTING DEVICES 


In order to give you permanent records of your work sessions, HHC 
printing devices include two printers and a color plotter. 


The Mini Printer 
The Mini Printer, shown in Figure 9-3, print 
rolls that are 80 mm (about 3-1/2 inches) wi 
portable device for getting hard copy from your 


s 40-character lines on paper 
de, making ita convenient, 
HHC. Figure 9-4 shows its 


parts. 
output with a5 x7 dot matrix for each - 


The Mini Printer produces 
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MIN! PRINTER 





Figure 0.4, The Mini Printer 








‘Transparent cover 
/ Paper cutter 
f Print head 


/ ; Paper feed wheel 
! 





i f 
Paper Print 
chamber har 


Figure 9-4. Parts of the Mini Printer, profile view 


character. Its “ pips eae | : 
Inga row ne ee printing mechanism produces characters by aetival 
thn osinter iny heating elements as they pass over the paper. | his maken 
‘r very quiet and reliable. Th : ‘ua SW 
ble. The only moving parts move , 
head back =< ; ng parts move the print 
aie = and torth and advance the paper between lines. The dherinil 
C'on “Tye & scqfientir a +4 
ot sa act a for the Mint Printer are shown in Table Yel 
Se tne ry Spat : 1 
re e Mint Printer, first unpack it and plug it into the HH, either 
directly or through the [/O Adaptor : | 
A transpare astic Cc 
Bildsithe : Ks Line cover Is located on the printer's paper chamber 
! ‘cover backward and then re 3 | 
oes i emove il, Youare a adele 
Mint Printer with paper. now ready to OMG tHe 
Consult Figure 9- | oe 
aa Ha 3-5 while you load paper into your printer, Unwrap (he 
sane papel lat comes with the printer, Ifthe paper is ragged, eut the end ae 
Is ATL | ‘pape " = ‘ Fe i uit 
eta ‘ ae Feed the paper through the slot at the front of the payet 
i “T SLene ES ee aah en 
est turn the paper feed” wheel to make the printer pull the paper 
be ce ,] i i , . | peel 
ote Hi rint bar. Now drop (he pod poe rollinto the papel chamber, After 
dip the cover aver the chamber, the printer is ready for use | 
o operate the Mint Printer e | | uv 
7 cane (hit Mini Printer connect tt ta your PLAC and select i trom the 
| ‘ Vy h a 
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Printer, The documentation accompanying each program capsule identifies 
which peripherals the program can communicate with. 

The Mini Printer prints an entire line when it receives an “end of line” 
character or a full output line of 40 characters. If a program slaves the 
printer to the LCD, the Mini Printer will not begin to print a line until that 
line disappears from the LCD. 

The Mini Printer can print all the characters in the HHC’s character set, 


s+ coc. wa 


including inverse-image characters and unusual characters like “a,” “0, 


7 oo 45 


ua.” and “Ti. | 
Hach time it finishes printing a line, the Mini Printer advances the paper 
one line. However, unlike many larger printers, it cannot print one line on 


top of another by performing a “carriage return without line feed” or print 
one character on top of another by backspacing. 


Table G-1. Printer and Plotter Characteristics 


: ‘ x he : Four Color 


Printing Therma dot Thermal dat Turrent holding 
matllX matrix 4 ballpoint pens 
§ x 7 dots/char G.2mem) step. 
horizontal and: - 
vertical 
96mm (4), 16 
character sizes, 13 
to 80 chars/line 
(40 chars/ linc 
standard} 
plain, roll, 
[l4mm * & m 
(6-1/2" * 26’) 
6 char/sec with 
40 char line: 
smaller chars 
print faster 


Wea (We Hx D) | 1I38% 53% 94mm | 113.5 % 61 & Ysmim 997 we $8 OSmm 





























mechanism 





Resolution § x 7 dots/char 

















40 char/ line 





Maximum bine 1§ char) line 


length characters 





















Thermal, rol, 
80mm < & m 
(3-1/2" *% 26°) 
20 char; sec; 
depends on 
line length 


hermal, roll, 
4mm = Rm 
Fi 96) 
1.5 lines/sec 
regardless of 
line length 


Paper type 


Approximate 
printing speed 













(4.1/2 * 2-1/16 (4-1/2 % 2-13/32 (8-15) 16% 2-9/32 
+ q {/ 4) pd 43 14”) ’ t ha") 
Weigelt A50o (1 tb) 550¢ (1 lb 3.4 07) O00 (2 lb | ov) 
Power aouree Huiliein batteries Muiltein batleries Hitiltean batteries 
recharged by AG recharged by At pecharged by AC 
bilan patent claphent iibapin, draws 
Wat) en W 
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Figure 9-5. Loading paper on the Mini Printer 


| A special feature of the Mini Printer and of many other HHC peripherals 
is word wrap. Ifa program tries to printa line that is more than 40 characters 
long, the printer automatically breaks the line into two shorter lines alte 
PaHUne as many complete words as will fit on the first line. The orinter 

wraps” the entire word that does not fit on the first line onto the beginning 


of the next line, This line divisi ! 
: on may take place before the printer Tt 
40 characters. P produces 


The Micro Printer 


| rhe Micro Printer, shown in Figure 9-6, is a thermal printer, It is very 
similar to the Mini Printer but smaller and lighter. The Micro Printer Can 
print lines with as many as [5 characters on thermal paper that is 38 mim 
(about [-f/2 inches) wide. Its usefulness is limited by its s! li ole 
— y its short line length 
Min Printer instructions apply equally to the Micro Printer, except that 
the “line feed” control for the Miero Printer is a push button rathe: (hana 
Knurled wheel and the paper chamber cover is hinged at the front, You 
remove the cover by pushing up on ita back, When you replace the caves 
you muat feed the end of the paper through the slot in ite top | 


Seer et Vee F ee ere Fee I Led 





The Mow-Color Plotter 


Although it prints more slowly than the Micro Printer and Mini Priater, 
He PoureColor Plotter, shown in Figure 9-7, can produce charts, preystia, 
dit ather kinds of diagrams ona roll of plain, nonthermal paper, You ean 
Hae fl Plotter as a printer with several different sizes of characters, 

The Plotter both prints and plots with a turret containing four ballpoint 
pena, Shown in Figure 9-8, the turret moves along the paper to produce 
Hailsontal motion and rotates so that the pen colors can be changed, the 
jiaper rolls up and down to produce vertical motion, and the pen lifts off the 
perio move the turret without drawing. 

Horizontal and vertical motion take place in steps of 0.2 mm (about 1/194 
leh), [his step is small enough to produce many types of accurate, plesaing 
prapiies yet large enough to be visible so, as a result, it is inappropriate for 
PAROLIN Applications, Figure 9-9 is an example of graphics rendered by the 
Matter, 


The Plotter Paper 


To installa roll of paper, remove the cover from the Plotter and consult 
Pigure 9-10. Gently press down on the grooved tabs at the cover's back 
vorners and then press forward. Use only paper rolls supplied for the HH 


Figure 9-6. The Micro Printer (upper left corner) with | Matter by an authorized HHC distributor. Other types of paper muy 
the HHC and 1/O Adaptor | produce unsatisfactory results. 
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(black) 


Position | 
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(green) 
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Figure 9-7. The Four Color Plotter : Figure 9-8. Close-up of Plotter pen turret 
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Figure 9-10, Loading paper on the Platter 





Figure Se 11. Plottlag turret in heme PHOmItiOn 
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Attach the Plotter to the HHC and connect the HHC toan AC Adaptag, 
Raise the arms of the Plotter’s paper holder and slip the core of the paper rol 
over the pins at the ends of the arms. You can do this more cusily by pulling 
outward on the right-hand pin. 

Now cut the end of the paper roll so that its edge is even and insert the en 
in the paper inlet at the back of the Plotter. When the paper stops, press the 
PAPER FEED button long enough to feed an inch or s0 of paper past the pen 
turret and then replace the Plotter’s cover. 


The Plotter Pens 


The HHC Plotter uses ballpoint pens that are designed to fit the ploting 
turret, Use only pens supplied for the HHC Plotter by an authorized HI 
distributor. 

Before installing the pens, remove the cover from the Plotter and attach 
the Plotter to the HHC and AC Adaptor, just as you do when you inatall 
paper. 

The turret holds four pens filled with black, blue, green, and red ink, Ta 
mount the pens in the correct slots, turn onthe HHC and press CLEAR, [lis 
makes the Plotter return the pen turret to the left margin and position the 
turret so that the “black” pen position is uppermost. Figure 9-11 shows the 
turret in its “home” position. 





L1Q Te HHC User Guide 


After you press CLEAR, you should see a small metal bar in the ae 

divider located to the left of the uppermost pen. This bar is a magnet that the 
S siti i turret. 

Plotter uses to sense the position of the . | eas 

Now press the PEN CHANGE button and the plotting turret will HO} a - 
“nen change” position at the right end of theplaten. Slip the pen with blac 
ink into the turret slot, writing tip first. | a 

Press the COLOR CHANGE and PEN CHANGE buttons again. Now insert 
the pen with blue ink. Repeat this procedure for the third and iy pens 
(green and red). Now replace the cover and you are ready to use the Plotter. 


Caution: Do not rotate the turret by hand or touch any part of e 
mechanism in ways not described here. This part of the Plotter is rather 
delicate and easily damaged. 3 : 

Never operate the Plotter without all four pens in place. If you break 
this rule, you may damage the Plotter’s mechanism. 


“a 


Changing or Removing Pens 


You must remove the pens to change them when they run dry. li you do 
not use the Plotter for more than a few days, protect the pens irom drying 
out by removing them from the Plotter Ee storing them inthe four ate age 
‘lots located under the Plotter’s removable cover. 
ig“ ees the pens, lift the Plotter’s cover. Press the PEN CHANGE ee 
to bring the turret to the pen change position. Gently rack the pen release 
lever. This lifts a wire below the pen, nudging the pen upward. Once the pen 
is clear of the turret, you can slide it out with your finger. Hold your anger 
over the pen to prevent it falling into the Plotter as you rock the pen release 
. Wthe pen slips under the wire, press the COLOR CHANGE button four at 
and the PEN CHANGE button once. This gets the wire back under the pen | y 
turning the turret through one complete revolution and returning tt to the 


pen changing position. 


Ifthe pen pops out of the turret and falls into the Plotter, turn the Plotter 


upside-down and let i drop out, eiche Ini 
Before you imstall a new pen, run it over tl sheet of paper so that the 


will bepin to flow, This aetion ensures that the pens will begin drawing as 


ago aa the Plotier aturta 
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Using the Plotter 


Built-in rechargeable batteries can operate the Plotter for at least an hour 
When the Plotter is not running, you can recharge its batteries with eithe 
the small or the large AC Adaptor. To recharge the Plotter while it {s 
running, you must use the large AC Adaptor. 

If several peripherals are in use, even the large AC Adaptor may be unable 
to recharge the Plotter while it is running. In such a situation, the AC 
Adaptor will extend the batteries’ life to about four hours of plotting time 

To use the Plotter, simply turn it on with the 1/O menu and run any 
program that operates the Plotter or a Printer. The Plotter operates as a 
printer until a program sends it a command that shifts it to plotting mad 
Thus, any program that slaves output devices to the LCD can operate thi 
Plotter because the program does not have to “know” about the Plotter’s 
graphic abilities. 

The Plotter has four control buttons: COLOR CHANGE, PEN CHANUI, 
PAPER FEED, and PAPER BACK FEED. You have already used the COLOK 
CHANGE and PEN CHANGE buttons. | 

The PAPER FEED button advances the paper continuously in plotting 
increments at a speed of about one inch per second. 

The PAPER BACK FEED button moves the paper backward in plotting 
increments. When first pressed, it moves the paper slowly, allowing you (6 
position the paper quite accurately. If you hold the PAPER BACK IVI 
button down for more than three seconds, it accelerates the paper's buick 
ward motion to about one inch per second, 


Plotter Capabilities 


The Plotter can operate in either of two modes: character mode or gra pride 
mode. 

In character mode, the Plotter functions as a conventional printer with 
backspace and reverse line feed commands, enabling it to move ts print 
head in all four directions. The character set is “programmed” by two 
built-in ROMs, 

The Plotter normally draws characters right-side-up, in black ink, and the 
standard character size produces a 40-character line. You can choose an 
orientation that 18 upside-down and backward, sideways reading up thi 
page, or sideways reading down the page, A program can at any time switeh 
to red, green, or hlue ink with any of several character sizes fram 1440 NO 
characters per line 


In graphic made, the latter las extensive plotting eapabilities, You cas 
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draw lines in any position and direction in several line types, including solid, 
dotted, and dashed. Lines are defined by the coordinates of each end point 
or by the coordinate of one end point and the relative position of the other. 
You can move the pen to any point without drawing a line. 

Circles, ellipses, radial lines, and Cartesian axes are all possibilities. 

You can use hatching of specified angle and density to fill in Squares and 
arcs, and draw sine and cosine curves of specified amplitude and frequency. 

If you print a string of characters, you can choose one of 16 different 
character sizes and change the orientation of characters. 

You can write your own plotting software in any programming language 
supported by the HHC. The Plotter’s user’s manual explains in detail how to 
use the Plotter to draw graphics. 


COMMUNICATION DEVICES 


The HHC has two communication devices: the RS-232C Interface and 
the Modem, The Modem is made with an optional Cassette Interface. All 
expand the HHC’s capabilities by allowing communications with other 
computers and data storage media. 


The RS-232C Interface 


sometimes called the serial interface, the RS-232C Interface enables your 
HHC to communicate with any device that fallows the RS-232C communi- 
cation standard. 

Since most computers conform to the RS-232C communication stan- 
dard, you can use the RS-232C Interface to transfer data directly between 
your HHC and another computer. 

Using the RS-232C Interface, you can connect your HHC to printers, 
video and printing terminals, disk and tape recording devices, and modems 
that Conduct computer communications by telephone. 

The RS-232C Interface can read and write data at data rates as high as 
9600 bits per second, a rate that corresponds to about 960 characters per 
second or—as it is more commonly known—9600 baud. 

Il you wish to connect your RS-232C Interface to the RS-232C device, 
you must use a cable with a25-pin DB-25 connector at each end. You can 
purchase these cables from your HHC dealer or from most computer supply 
dealers, or get a service technician to wire one for you. 

Since different devices require cables wired in different ways, HHC 
distributors sell three types for use with the RS2VC Interne 
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lhe straight cable eonnects every required pin of one plug to the carve 
sponding pin of the athe: plug and is used to connect the RS-242C Interface 
lo a serial interface modem, This cable is described in the RS-242C seetian 
of your HHC owner's manual under the heading “Connection To the 
Modem.” The HHC'’s RS-232C Interface is configured as data terminal 
equipment, not data communication equipment. Unlike other RS247¢ 
interfaces it is connected to modems witha straight cable and to devices sueh 
as terminals and printers with a crossed cable. 

A crossed cable cross-connects certain pairs of pins in the two plups and {a 
used to connect the RS-232C Interface to a printer, display terminal, o4 
similar serial interface device. It is described in the RS-232C section of yout 
HHC owner’s manual under the heading “Connection Between HH,” 

The third type of cable is wired to every pin of a plug at one end but is 
completely unwired at the other end. Since you can wire this cable any way 
you want, you can use it with a device that has special! cabling requiremerita 

Unless you have some prior experience with computer hardware, haw 
ever, leave cable wiring to an experienced technician. It isa demanding task, 
and few people do a respectable job the first time they try it, 

To prepare the RS-232C Interface for use. you must have a device capaul 
intended for the RS-232C Interface, such as the R 5-232C Communications 
capsule. Although intended primarily for the Modem, the 7 clecompuling | 
and 2 capsules also work. 

Remove the sliding panel on the bottom of your RS-232C Intertace 
Beneath tt you will find a capsule socket and a row of eight slide switelies 
Insert your device capsule in the socket. 


Configuring the Interface 


You must decide at what baud rare, or data transmission rate, you want th 
RS-232C Interface to run. To transfer information correctly, the RSe21Ie 
Interface on your HHC and on the other device must cun at the same rate 

some devices operate at a fixed baud rate, while others let you choone a 
rate. In general, choose the highest rate that the HHC and (he other devia 
can handle, 

The highest baud rate at which you ean operate the RS-249C Interlace 
may be limited by some HiIC software Programs, Hf you are not sure what 
baud rate to use, eatabliah Communication at 400 baud and then paise the 
baud rate until you find the highest rate at whieh your HC and program 
work reliably 
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[he slide switches next to the capsule socket control the RS-232C Inter- 
face's baud rate. Table 9-2 will help you choose the proper slide switch 
settings, 

RS-232C parameters must be set properly on the RS-232C Interface and 
the other device before the RS-232C Interface can communicate success- 
fully. All of these parameters except baud rate are set through software, 
generally by a CONFIGURE menu item in an application program inthe 
device capsule. 

For information about the parameters that you can set and the procedure 
used to determine their values, see the user’s manual for the specific equip- 
ment you are employing. Most of these manuals contain lists of configuration 
parameters that are appropriate for common types of devices. 

If you are not sure how to configure the Interface, don’t be afraid to 
experiment. You cannot hurt the Interface or the other device by choosing 
Incorrect parameters. 

To use the RS-232C Interface, connect it to the HHC. Then 

Step 7, Connect the data cable to the RS-232C Interface’s DB-25 socket 

and to the device or other computer, 


Step 2. Turn on the device or other computer, if you have not already 
done sa. 


Step 3. Turn on the RS-232C Interface with the 1/O menu. 


Step #4. Runa program that reads, writes, or both reads and writes to the 
RS-232C Interface. 


Troubleshooting 


Configuring an RS-232C Interface to a peripheral device or computer is, 
uniortunately, one of the more complicated procedures in computing. 
Many problems can occur, and most of them result in the same symptom: 
No data are transferred. 

If you connect your RS-232C Interface and it doesn’t work, you have to 
follow a troubleshooting checklist. | | 

l‘irst, make sure your cable is wired as directed. If your cable has an 
“HHC end” and an “other end,” try reversing the cable. Try this particularly 
if your HHC is connected to another computer and if the other computer 
“freezes” when it should send a character to the HHC, 

Next check the baud rate settings and other parameters on the RS-232C 
Interface and the peripheral device to sce if you set ane of them ineverrectly, 
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Table 9-2, RA TVt Haid Wate and Switeh Settings 
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Baud Nate sel These All 
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4800 4&0) f 
960) 960 5 





Chis is particularly likely if data get through the connection but are garbled 
or if everything received by the HHC looks like an inverse-image "(0" of aut 


After rereading the instructions very carefully, make sure the prapet 
software is running on the HHC and on your companion computer and then 
make sure you are using the software correctly. When everything seem to 
work right, but no data cross the RS-232C Interface, checking your softwar 
is a particularly important task. 

If these rules of thumb don’t help, you will need experienced technical 
assistance, 


The Modem 


The Modem enables your HHC to communicate with another modem 
equipped computer over an ordinary telephone line. A modem can be an 


rm acoustic coupler ora direct-connect modem. The HHC’s Modem peripheral 


js an acoustic coupler. Shown in Figure 9-12, the HHC’s Modem is often 
useful in portable computing applications because it can connect the HHC 
toa larger host computer, With this setup you can wep/oad information fram 
the NHC to the host or down/oad information from the host to the HHEG, 
Uploading and downloading are discussed in Chapter 8. 

The Modem is available with a Cassette Interface that lets you tranales 
HH files to and from magnetic tape using an audio cassette recorder, The 
Cassette Interface peripheral is described tater in this chaptes 
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Figure 9-12. Acoustic Coupler Modem with phone handset 


To prepare the Modem for use, you must have a device capsule intended 
lor the Modem—for example, the Telecomputing | and Telecomputing 2 
capsules. 

Remove the sliding panel on the bottom of the Modem and insert your 
device capsule in the socket beneath the panel. 


Configuring the Modem 


On the bottom of the Modem is a slide switch with settings labeled TEST 
and NORMAL. 

The TEST setting connects the Modem’s output circuit directly to its input 
circuit, To test whether the Modem’s digital circuitry is in operating cond1- 
tion, set the TEST/NORMAL switch to TEST, connect the Modem to your 
HEC and turn it on, and then run any communications program that uses 
the Modem in its “terminal mode.” Telecomputing 2 is a good example. The 
HALF/ FULL DUPLEX configuration option must be set to FULL. 

When you are ready to use the Modem, the switch should be set to 
NORMAL. 

linally, type on your HHC’s keyboard. Whatever you type should appear 
on the LCD, just as though the HHC had received it over the Modem. 
Uniortunately, because the TEST switch does not test the Modem's speaker, 
microphone, or filter circuits, there is no absolute proof that the Modem is 
working properly, The ultimate test is use. 
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The Modem haa a number af parameters that must be set properly il tt is 
lo communicate succenmfully, All of these parameters are set through soft 
ware, generally by aCONPTGURE menu item in an application program in 
the device capsule, 

ror lists of configuration parameters appropriate for communicating 
with most common types of computer systems, see the user’s manual for the 
ciupsule you are using. 

If you are not sure how to coniigure the Modem, don’t be afraid ta 
experiment. You cannot hurt the Modem or your companion computer by 
using Incorrect parameters. The worst thing that can happen is that the other 
computer will fail to “hang up the phone” after one of your attempts (o 
communicate, and you will have to ask a host-site operator to make it “hanp 
up’ so that you can try again. 

The Modem, unlike the RS-232C Interface, has a baud rate paramete 
that is established by software. Although most modern telecommunications 
systems run at 300 baud, the Modem gives you a choice of 110 or 300 baud 

The exact procedure for using the Modem may vary with the device 
capsule you are using. This section shows you how to use a Modem with the 
Telecomputing 2 capsule, the one most commonly used with this device, 

First, connect the Modem to the HHC. Then use the 1/O menu to turn on 
the INPUT and OUTPUT sides of the Modem. At this point the Modem will 
produce a continuous, high-pitched whine called a carrier signal, By modu 
lating the tone of this signal, a Modem transmits data. 

Now let’s prepare the HHC program to communicate over the Modem, [1 
Telecomputing 2, start the program so that you see the CONNECT/CON 
hIGURE menu and select the CONNECT item. The carrier signal should 
stop, 

Now dial the telephone number of the other computer on any telephone 
with a standard handset. If the other computer has an auio-answer modem, 
a device that “answers the phone” automatically, you should hear anothe! 
carrier signal over the phone after a few rings. If the other computer does not 
have auto-answer, a person at the other end must pick up the phone when 
you call and push faehinare into the modem, just as you are about to do i 
your end. 

Push the telephone handset into the rubber cups (top of the Modem), The 
cord end should face nway from the HHC oc the [/O Adaptor, as shown in” 
the diagram (top of the Madem), The HHC's ON LINE blip should ¢o on 
when it detects the olher computers carrier signal, The word “CONNECT, 
displayed by Telecomputing ? when you selected CONNECT from the 
“CONNECT/CONTIOUTED” ment, abould disappear, clearing the LED, 
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You have now established communications between your HHCand your 
companion computer. 


Troubleshooting 


There are some test procedures to try if your Modem does not work as you 
expected. | 

If the other computer never answers the phone or gives no response to the 
data you send, it may be out of order. 

If the ON LINE blip does not go on when you press the telephone handset 
into the Modem’s rubber cups, then you did not receive a carrier signal from 
the other computer, the TEST/NORMAL switch is not set to NORMAL, you 
Inserted the handset backward, or your Modem is set to ANSWER, not 
ORIGINATE, 

If the HHC displays a message like “CONNECTION LOST”, or if 
nothing happens and you cannot hear a carrier signal over the telephone 
when you lift it out of the Modem, the other computer was probably unable 
lo make connections with your Modem and “hung up the phone.” Try again. 
Practice inserting the phone in the Modem so that you can do it promptly 
when you hear the carrier signal: make sure the HHC’s Modem is turned on 
and in CONNECT mode before you start. ; 

Check the configuration parameters that you set for the Modem—. 
especially if you make the connection but the data ¥You send are garbled in 
(ransmission, 

Make sure you are running the proper software on the HHC and the 
companion computer and that you are using the software correctly. 

If these test procedures don’t help, you will need experienced technical 
‘NSIStance, 


Modem with Cassette Interface 


The Modem can be purchased with an optional Cassette Interface, as 
shown in Figure 9-13, that lets you save HHC data on Magnetic tape with an 
ordinary cassette recorder, Like the standard Modem, the Cassette Interface 
connects to the telephone system, as shown in Figure 9-{4. The Cassette 
Interface provides a cheap, compact medium for backing up or transporting 
HH files. 

The operating principle of the Cassette Interface is simple; The modulated 
carrier signal normally fed to the Modem's “send” Cup IN instead fed to the 
cussetle recorder, The cassette recorder saves this carrier alynial—and the 
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Figure 9-13. Modem with Cassette Interface 


information contained in it—on tape, just as it would save any ee I Ndi 
sound. Later, the cassette recorder plays back the carrier signal t uM oe ith | 
Modem, and the Modem detects the data just as if the carrier signal were 
coming over a telephone. | | | | 

In order to save files on tape, you must have an HHC anda sigan pe 
Cassette Interface. You also need Telecomputing 2 or any othet 





Figure 0.14, Modei wilh plone tiontae 
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program that can transfer a file from the HHC’s File System to the Modem 
and back without expecting any sort of response. You need this kind of 
program because a cassette recorder by itself cannot respond to incoming 
data, 

linally, you need a cassette recorder with a jack for an external micro- 
phone and a jack for earphones. A double cabic that is supplied with the 
Modem connects the two jacks on the Modem to the cassette recorder’s 
microphone and earphone jacks. 

To prepare the Modem for use with the Cassette Interface, connect the 
Modem to the HHC, and turn it on with the I/O menu. 

Now set the following configuration parameters: 


RLF OUPLE® 
JU Ge Ll BAO 
ALATA BITS 
MASK LST BIT 

2 STOP BITS 


IGNORE PARITY 


NO XON/ OFF 


VIVEG LF ORF 


If you are using Telecomputing 2 to record a nontext file, set the Modem’s 
data rate to [10 baud. To record a text file, you may use either 110 or 300 
baud. The higher rate is faster; but if you are using an inexpensive recorder, 
[10 baud is more reliable. 

Use the double cable to connect the Modem’s SAVE OUT jack to the 
recorder’s “microphone” jack and the Modem's LOAD IN jack to the 
recorders “earphone” or “monitor” jack, When you plug the cable inte both 
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jacks, the Modem‘'s audible carrier signal stops. At this point the Modem 
directs its outpul to the SAVE OUT jack. 

Now turn on the recorder’s POWER switch and adjust the recorders 
controls, Set the recorder’s “volume” or “playback volume” control to 4 
level you would use to play back normal conversation. If the recorder has a 
separate “record volume” control, set it to a level that you would use to 
record normal conversation. If the recorder has a MUSIC; TALK Switch, set I 


lo MUSIC, 


Saving and Loading Files 


To save a file with the Cassette Interface, insert a tape cassette in the 
recorder and rewind the tape to its beginning. Place the HHC tn CONNIC1 
mode. At this stage the HHC may begin receiving random characters from 
the recorder and displaying them on the LCD. 

Prepare the program you are running to save a file on the recorder that 
is, perform all steps necessary to save a file except the last. 

If you are using Telecomputing 2, press the SEND key to save a text file a 
press SHIFT and SEND to save a nontext file. The SEND key is actually tl 
ROTATE key relabeled with the Telecomputing 2 keyboard overlay, Inaped! 
the menu of sendable files that SEND displays and verify the presenee al tht 
file you want to save. 

Make the recorder begin recording. Wait about ten seconds while (lt 
tape’s nonrecording leader is going by the recording head. When the lender 
has gone by, random characters will stop appearing on the LCD, Allow the 
recorder to record another few seconds of “file leader” before proceeding 

Now perform the last step necessary to make the program begin saving the 
file. If you are using Telecomputing 2, select the file you want to save from 
the program’s menu. 

When the program has finished saving the file, allow the recorder to 
record another ten seconds or so of “file trailer.” Then stop the recorder and 
press the HHC’s CLEAR key. 

To reload a file through the Cassette Interface, insert the tape casselte 
containing the file in the recorder and rewind the tape to its beginning, Afte 
you place the HHC in CONNECT mode, make the recorder begin playing 
back the file and wait until (he recorder gets past the end of the nonrecordinig 
leader on the tape, While the tape in running past the empty “file leader,” 
instruct the program you are running to receive or reload the file, [you are 
using Telecomputing 2, preak the WROLIVE key, or press SHIFT and RECTIVI 
io yelond # nonteal (He the HPOPIVE key is vctually the — key, relabeled 
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with the Telecomputing 2 keyboard overlay. Type the name you want to give 
the reloaded file, and press ENTER. The LCD cursor disappears and the 
program begins waiting for the file. 

When the LCD cursor reappears, signaling that the program has finished 
reloading the file, press the HHC’s CLEAR key and stop the recorder. You 
should perform these steps while the recorder is playing back the empty 
“trailer” that you recorded at the end of the file. 

You may have to experiment with the recorder’s volume setting to make 
the Cassette Interface work reliably, To get the most reliable operation, 
experiment until you find the highest and lowest setting at which the 
Cassette Interface works and then set the volume midway between those 
points. 

When you record important data, always play back the recording to check 
it for correctness. Like telecomputing, cassette recording of data is some- 
what prone to errors, 


Several Files on One Tape 


The Cassette Interface needs very little tape to save a typical HHC file. At 
300 baud the Interface takes about 2 minutes and 15 seconds to record a 
4000-byte text file, while most cassette tapes can record for 30 or 45 minutes 
per side. If you record only one file per tape, you are wasting a lot of tape. 

You can make more economical! use of your tapes by recording several] 
liles on cach tape. Simply wind the tape toa position after the last saved file 
when you are ready to save another file. 

Use your recorder’s tape meter to keep track of the location of each file. 
lo identify each file you may wish to record an introductory voice message 
that describes the file’s contents, the date the file was saved. and other 
important information, 

lable 9-3 summarizes characteristics of the RS-232C Interface and 
Modem communications devices. 


DISPLAY DEVICES 


[he TY Adaptor is a display device designed to give you large-screen 
cditing, text processing, and graphics capabilities. 


The TV Adaptor 


The TY Adaptor, also known as a video adaptor, enables your HHC to 
display information on a television set ora video monitor like the aet shown 
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Table 9-3, Cominunieation Devices’ Characteristics 


RS-232C 


Interface Modem 
Communicates with | Other RS-232C | Other computers a1 
devices, &.g., printers devices, by phone; 
terminals, modems cussette recorders 
Device capsule slots | — 
Speed 50, 75, 110, 150, [10 or 300 baud 
200, 300, 600, 1200, (approximately I 
2400, 4800, and 9600 | or 30 char/ second) 
baud (approximately | software selected 


5 to 960 char, second), 
switch selected 





Full’ half duplex 

5to 8 data bits 

l or 2 stop bits 
Odd/even/no panty 
Originate/answer mode 





Full haif duplex 
Sto data bits 
l or 2 stop bits 
Odd/even/no panty 


113.5% 61 *% 95mm 
(4-1/2 % 2-13) 32 

3-3/4") 
350g (12.35 02) 
HHC main unit: 
draws 650 mW 





Other parameters 









TEST: NORMAL SWitel 






Other features 





227 56.5 * 9Smm 
(8-15/ 16% 2-7/2 
x 3-3/4") 
550¢ (1 Ib 3.4 G7) 
HH€ main unit; 
draws 130 mW 


Ss 






Size (WX H& D) 


Power source 














in Figure 9-15. The TY Adaptor produces an instantaneous, noiseless 
display and consumes no paper. It can display as many as 16 lines of 4? 
characters, including all of the HHC’s special LCD characters, The IV 
Adaptor can also duplicate all of the LCD’s blinking and inverse-!imnge 
characters and other special display modes and can display a complete set o! 
Katakana (Japanese alphabetic) characters. Appendix D describes some of 
these characters. With appropriate software and a color television set 01 
monitor, the TV Adaptor can display graphics and other color images, Text 
and graphic output can be combined in some of the graphic modes. 
Table 9-4 summarizes the characteristics of the TY Adaptor. 


Television Set or Monitor 
You can use the TY Adaptor with either an ordinary television set or a 
video monitor denigned aperifieally to display computer images, Since mont 
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people already own television sets, they have the advantage of ec 
Phe TV Adaptor modulates its image into a carrier eek isk pitt te 
were & television transmitter. The TV Adaptor feeds the 5 hi a ; 
lelevision set through its antenna connection. aula as 
A video monitor offers a clearer image than a television set. since it feed 
the Ly Adaptor’s Image-forming signal directly into its display tube’s d i 
circuits, This sequence climinates two intermediate ihn Shadi sia 


Image into a carrier signal in the TV Ad 
: : i aptor a , a 
the display device. ptor and then demodulating it in 


Vi 1 : r “) w H 
ideo ee are made in color, black-and-white. and “green screen” 
ersions, A“ ah NS 7 fi a | 
Breen screen” is like black-and-white, but displays a green 


image instead of a white I 
7 om tead of a white one. Many people find éreen screens sharper and 
easier to look at for long periods 


@eCOrPY FILE 
satear 
Aercelelog 
i=HEL FILE 
gecoryY FILE 
ater 
4eteleles 
{=sNEW FILE 
eecorpy FILE 
eT eaF 
dutelelog 
is ee 
geecOPy FILE 
jetesr 
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Table 9-4. Memory agi Display Devices’ Characteristics 


Programmable | 
Memory 
| Peripheral 
TExpands HHC's 
RAM 


| Punetioen 


Characteristics 4K. 8K, or 16K - 
non-volatile 
RAM storage 


260 (9oz) with 
batteries 


113 % 30.5 & 
95mm (4-1/2 
1-316 X 3-3/4") | 
HHC main unit; 
draws 20 mW. In 
4K and §K PMPs. 
AJ replaceable AAA 
cells maintain memory 
when device Is 
disconnected or 
turned olf, 16K 
|) PM P's use long- 
life lithium 
batteries that must 
be replaced at 

an HHC service 
center. 


Power source 





[/ Adaptor 


Connects up ta 6 
peripherals to HHC 


Large tray holds 
HHC and 2 
peripherals. 
Detachable small tray 
holds 3 more 
peripherals, Top 
socket connects | 
peripheral by cable. 


~1100g (2 Ib 6.8 a2) 


with small tray 
attached 


425.5% 51 X 
318 mim (16-3/4 
M2 12-7) 32" _ 
HHC main unit: 
draws 20 mW 


125 


TY Adaptor 


Communicates with 
television set or 
video monitor 
Text mode; 16 lines 
™ 32 characters, 

50 7 dots/ char, 

has word wrap 
Graphics mode; 
32% 64, 4k OX 64, 1 
64> 128 pixels 


Colors: green, yellow, 
blue, red, bull, cyan, 

magenta, and ornnype 
227 * 30.5% Y4Smm 

(8-15/ 16% 14/16 

*~ 3-3/4") 


500g (1 lb L.64 av) 
Large AC 


Adaptor only, 
draws 1.5 W 


computer stores and (television stores, They cost about as muchas television 
sets of similar size, 
Video monitor signals are Completely standardized, so you need not be 
concerned about TV Adaptor and monitor incompatibility, 
Some modern television sete live image input jacks that let them double 
as video monitors, 





Figure 9-18. The TV Adaptor and HHC with a video HSN 
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Touse the TV Adaptor witha television set, turn your TV Adaptor so that 
the bottom faces you and then locate the SLIDE switch labeled C H3/CH4. 
This switch selects the television channel on which the TV Adaptor will 

“transmit.” If one of these channels is used by a television station in your 
area, choose the other one. 

Connect the TV Adaptor to your HHC. 

Packed with your TV Adaptor is a cable with a coaxial-cable plug at one 
end and a pair of spade lugs at the opposite end. Screw the plug end of this 
cable into the TV Adaptor jack labeled RE OUT. Attach the opposite end to 
the television set’s antenna terminals. 

Switch on the television set and turn the selector to either Channel 3 or 
Channel 4 to match the TV Adaptor’s channel selector switch. 

To use the TV Adaptor witha video monitor, cpnnect the TV Adaptor to 
your HHC, 

Packed with the TV Adaptor isa cable with an RCA pin plug at each end 
like the ones used to hook up stereo components. Plug one end of this cable 
into the TV Adaptor jack labeled VIDEO OUT and plug the opposite end into 
the input jack on your video monitar, If your monitor’s only input is a 
coaxlal-cable socket, you will need an adaptor to connect the pin plug tothe 
coaxial sacket. 

If your monitor has a DATA/PICTURE switch, set it to DATA. If vour 
monitor has an IMPEDANCE switch, set it to the HIGH position. Your 
monitor has an instruction book with additional information. 


Power Requirements and Operation 


The TV Adaptor runs only with the HHC’s large AC Adaptor. It has no 
built-in batteries, and the small AC Adaptor cannot meet its power 
requirements. 

If you try to run the TV Adaptor without the AC et the ay, 
Adaptor will not appear in the [/O key’s menu. 

To use the TV Adaptor, turn on the monitor or ievision: set, then your 
HHC, and finally the TY Adaptor with the i/O menu. The background 
color lights up on your TV or monitor. 

Select the File System editor or any other program that uses the TY 
Adaptor for output. An image of the program’s output should appear on the 
screen. Adjust the controls of the monitor or television sel (6 pet the best 
possible image. If you are using a television set, first adjust the fine tuning 
control, 
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Information required to write a program that uses the TY Adaptors 
graphics capabilities is presented in Appendix b 


NEW DEVELOPMENTS 


An FPROM Burner peripheral that plugs direetly into an HC peri 
eralsocket is under development and should soon be available commercially 

(his EPROM Burner will accept 2K and 4K EPROM capsules wile 
the adaptor required by other EPROM burners and will be accompanied 
a utility program for burning, reading, verifying, and modifying Tt 
oupsules or device capsules. 

Keepin touch with your HHC dealer for information about this aid owe) 
new products, 


SUMMARY 

fo use a peripheral, you must 

» Turn off the HHC 

» Connect the peripheral to your HIIC’s peripheral socket 

© Turn onthe HHC 

“Turn on the peripheral with the 1/0 key and the 1/QO menu 

' Runa program that ean operate the peripheral 

' Enter the specific commands (if any) needed to make the properiin ia 

ihe peripheral, 

lo connect or disconnect a peripheral you must observe (he fallow 
rules and suggestions: 

«Turn your HHC off before connecting or disconnecting anything 


' Return your HHC to the primary menu [trst, or the operating syatem 
Will automatically return it to the primary menu, Sinee you ean 
connect a peripheral while you are running & program, denneet all ih 
peripherals you will need before you start the program 


‘ Sinee your MINC’s operating system (urns all peripherals off whenever 
you connect of disconneet one, (urn them back on with the ft bey 


VOU afill need! them 
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Observe the following rules when you turn a peripheral on or off: 


* Turn peripherals on and off with the 1/0 key and the 1/O menu. You 
can turn peripherals on or off at any time without disturbing the 
program that is running, 


* if a peripheral can perform both input and output tasks, the I/O menu 
lists it twice—-once for input and once for output. Remember to turn 
both menu items on or off. 





' When you connect or disconnect oné peripheral, the HHC's operating 
system turns all peripherals off. 


‘ The CLEAR, ON, and OFF keys do not affect the on or off status of a 
Peripheral. If you turn the HHC off, all the peripherals will become 
inactive. When you turn the H HC on again, the peripherals that were on 
before will go on again. 


HHC Quick Reference 


This appendix is a quick reference to such File System program Collin 
features as cursor motion, inserting, deleting, canceling, WN re 
t L h oY ; | pe : ) | 
rupting, and searching (Table A-1), to the Calculator (Tabk Av2), wn 1 : 
Clock/ Controller (Table A-3). For tutorials on these subjects, conaull 
ck | C 7 
Chapters 3, 4, and 5, respectively. 


Lait) 
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Table A-1. File System Editing Table A-l, Mile Svaiem Pdiling t ontinued) 


Press (continued) 
LOCK INSERT LOCK | 


Cursor Mation To insert fines foontinued) 


tom 


To move cursor one character) line: Press: si ol ot nbove 
at i an indefinite number, below LOCK INSERT LOCK | 
right current line 
up t 
ncn To delete lines: ial 
one, line above becomes current seule | 
Fo mave cursor to the extreme: Press: anes line below becomes current DELETE | . 
ia ee three lines, from current line up LOCK DELETE . - 
nem ee three lines. from current line down LOCK DELPT , 
ae Poe an indefinite number, from current LOCK DELETE LOCk 
down LOCK | lineup ee : 
an indefinite number, from current LOCK DELETE LOCK 
line down 
Insert and Delete 
To insert character(s) or space(s}. Press: Cancel, Review, Interrupt, and Search 
one character INSERT x To: Press: 
carina eee . Cancel effect of INSERT INSERT of DELUTI 
one space, after advancing the cursor INSERT Cancel effect of DELETE INSERT or DELETI 
characters LOCK INSERT xxxxx INSERT Review a line longer than LCD ROTA P _ ni 
three spaces left from cursor LOCK INSERT -— = Cancel effect of ROTATE any typing 01 ceding a 
three spaces right from cursor LOCK INSERT — —+ — Interrupt a “locked” operation any typing o1 editing key 
an indefinite number of spaces left LOCK INSERT LOCK — Find “string” (up to 12 characters SEARCH siring UN TEM 
from cursor lone} 
an indefinite number of spaces right LOCK INSERT LOCK > a 


irom cursor 


To delete: Press: 


the character under the blinking DELETE + 
cursor and move the cursor one 
space to the left 


the character under the blinking DELETE — 
cursor 
three characters left from cursor LOCK DELETE + — 
three characters right from cursor LOCK DELETE — —+ — 
an indefinite number of characters LOCK DELETE LOCK + 
left from cursor 
in indefinite number of characters LOCK DELETE LOCK 


right from cursor 





fo insert fines: Press: 
one, above current line INSERT I 
one, below current line INSERT | . 
three, above current line LOCK INSERT! TI 


three, below current line LOCK INaPAT I I 
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Table A-2. The Calculator | Table A-3. The Clack / Controle 





To cancel function: 





| Valid Keys Function: Procedure: 
Key Function 
ta9 Digits Set Alarm Choose option | 
Decimal point Set time; press ENTER 
ai Percent Type message; press ENTER Press CLEAR 
CM Clea 
RM Rae pe eee . Review Alarms Choose option 2 
inet memory lo display, replacing last For next message, press } 
isplay Male ; 
M+ ‘played number For preceding message, press 1 
Add last displayed number to memory For time, press — 
Subtract last displayed number from To redisplay message, press — Press CLEAR 
memory 
a2 —X+ Add, Subtract, Multiply, Divide Delete Alarm Choose option 2 
_ Equals; completes calculation Display alarm's message 
aol ae Move cursor left or right or time 
I Ciear entry or result Press DELETE, then Don’t press 
1,1, or CLEAR DELETE at this 
point 
Calculation: ; 
y Wet aes Acknowledge Choose option 3 
f vou press, fhe result ts: ° Alarm Display alarm’s message 
ath= Add a and or time ; 
a~bo-= Subtract 6 from a Press DELETE, then . Don’t press | 
axbp= Multiply a by 1, f, or CLEAR DELETE at this 
@ ig ; % Divide @ by 4 Pam 
if a a se a Fi OF, ; 7 . 
a—b% ; release see da Lisplay Time Choose option 4 
] hs ¥ i) we 7s =| 
amb % 5 % of g When done, press CLEAR Press CLEAR 
at b % ais & %& of what? Set Time Choose option 5 
To move cursor, press — or— key 
CM Clear memory Type in desired time 
RM Restore memory; replace last number on Eee ver HEESDEEBAR 
dispiay — 
‘eh Add last number on display to memory 
Subtract last number on display from 
memory 
Clear 
fo clear; Enter this: fe gto ee 
enter this; 
lawl entry t 
; Anyth se 
or result VEIT SIGE 
CLEAR, or — 
next number 
b+ CLEAR Nene munity 


Memory CM Anyviluiig ela 











Cautions 


This appendix summarizes guidelines for avoiding damage to the IIH 
and its peripherals. Some sources of damage are physical and electrical, 
while others involve software. 


PHYSICAL/ELECTRICAL HAZARDS 


The printers and the Four Color Plotter are particularly susceptible to 
damage from improper handling. 

To avoid damaging its mechanism, never operate the Plotter until all four 
pens are in place. When vou are changing pens or paper, never rotate the 
lurret by hand or touch any part of the mechanism except in accordance 
with the procedure described in Chapter 9. The owner’s manual also has 
instructions for safe and careful handling of the Plotter turret mechanism. 

The Mini Printer and Micro Printer also have delicate moving parts, 
particularly in the paper loading area. 

The Plotter and TV Adaptor have high power requirements, Do not 
attempt to operate the EY Adaptor without the large AC Adaptor attached, 
Although this will not damage it, i will not work. 

A major source of electrical damage to the HHC is Improper use of AC 
Adaptors, Many AC Adaptors dan be set for either 110 or 220 volt power, He 
sure Chat you set yout AC Ailaptor to match the voltage your electrical 
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outlet provides. lf you set the AC Adaptor to the wrong voltage, you may 
damage it severely, 

Although you need not purchase the AC Adaptor designed specifically 
for the HHC. your adaptor must deliver 9 volts at 300 milliamperes with 
negative voltage on the center pin. Some inexpensive adaptors have poor 
Voltage regulation. which can damage the HHC and its peripherals. Damage 
caused by using the HHC withan AC adaptor not designed for it will not be 
covered by the HHC’s Warranty. 

Remember to turn off the HHC before physically connecting or discon- 
necting any peripheral. You may damage the HHC or a peripheral if the 
HHC is on when a peripheral is connected or disconnecte . 


SOFTWARE 


Your files can be endangered during three main pertods: while you are 


editing, while you are running programs, and while you are storing pro- 


étams and files in the PMP. 

Since LOCK INSERT and LOCK DELETE Stay on until you cancel them, 
remember to cancel Lock DELETE and LOCK INSERT when you have fin- 
ished using the File System editor. If you leave them On, YOU May inadver- 
lently add or delete characters or whole lines in your file. 

Except in two taseS, YOU press the CLEAR key to reset the HHC after 
running a program. When you have Microsoft BASIC or SnapBASIC 
capsules installed in the HHC, however, do not press the CLEAR key or you 
will damage the files in the current file Space, 

With other Programs, you should wait a few seconds after entering the last 
Program operation before pressing the CLEAR key to allow the Program to 
store is data. 

The files stored in a Programmable Memory Peripheral (PMP) may be 
lost when you change batteries. Remember, the PMP must have some 
source of power for its Memory chips at all times. When it is not receiving 
Power from its own batteries, the PMP must be connected to the HHC. 

First, connect the PMP to the HHC. Make sure that the HHC;PMp 
combination is held securely ina plastic sleeve or other holder, Then remove 
he PMP's batteries and Insert new batteries 

If vou lose the H HC and PMP connection and the PMP js without 
batteries, all the files You stored in the PMP will be gone forever, 








Internal Hardware 
And Software 


4d . . . ; a es . j/ ‘cH { 

This appendix contains technical information primarily oe | 

: _ ay dey are FI 
programmers and hardware engineers who may develop new softw 


peripherals for the HHC. 


HHC HARDWARE 


The HHC includes a 6502 microprocessor with a 1 MHz o10Gs iis 
intrinsic RAM, bus interface, keyboard, LCD display, and batteries in ¢ 


integral unit. 


The HHC Memory Map | 
The HHC uses bank switching to address more faan is eee 
through its 64K address space. Table eal presents 7 cee a oe 
HHC. The capsule space (4000H to ees a operating 
three HHC capsule sockets on the a : ponent 10 a 
ystem als ses this space to store data for me y-mi ; i 
pe i irate (8000H to OBE PEFH) is stl Fehibtag ia i‘ ie i 
eral soeket containing the currently selected PMP, il any, he ¢ pa c ei 
spice (2000H to SPEPH) is bank-awitehed to a device control « | 
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Table C-1. Memory Map of the HHC 


Piet [amo [te [Pome 


IFFFH | Intrinsic Operating system and program 
data storage; File System 
storage 













Start 









OH 



















2000H 3FEFFH Intrinsic 


and extrinsic 


Device control capsules for 
peripherals; memory-mapped 
lo 

HHC capsules 
Programmable memory 
peripherals 

Operating system and 
intrinsic applications 

























4000H 
&000H 


TFFFH | 
QBFEFEFH | 


Extrinsic 
Extrinsic 















gCOOOH | QFRFFFH Intrinsic 


during I} O operations and during execution of anapplication program that 
resides in a device control capsule. 

Normally, all bank-switching operations are handled by the operating 
system. This process of bank-switching is transparent to the application 
program. 


Proprietary Parallel Bus 


The HHC uses a proprietary parallel bus with a 44-pin edge connector. 
Since the HHC’s peripheral socket connects directly to the bus, all HHC 
peripherals run directly off the bus. 

The HHC’s processor signals are not buffered; they connect directly to 
bus pins, This arrangement lowers cost, size, and power consumption, but it 
means that only one peripheral can be connected directly to the HHC main 
unit, 

lhe eight data bus imines from the 6502 microprocessor are connected 
directly to the bus, Of the 6502’s 16 address lines, 14 (AQ to A13) are 
connected to the bus and are sufficient to address 16K, the largest contig- 
uous region of RAM or ROM that appears in the HHC’s address space. 

Most of the 6502’s control signals appear on the bus. They include the two 
interrupts, the clock, R/ W, PS, and SYNC. 

The HHC has a sophisticated power supply and power control circuit. 
Four separate power lines present on the bus include unregulated supplies 
from the main unit’s battery and AC Adaptor, a regulated supply for CMOS 
1g, and at volt regulated supply present only when the CPU ia running, 
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protect the bus from damage make contact lirwt 
han the others, These three pins 
and Cause A 


The three bus pista uaed to 
because their connector pins are longer t ae 
activate the 6502's RESET line, suspend all bus activity, an a 
warning beep. When the connector is fully seated, the preveeuer i" re - . 
so that bus activity can resume. The bus protection mechanism i Ni 
activated if a connection becomes loose or a peripheral 18 disconnec te 

HHC distributors make complete bus specifications available ona ms 
disclosure basis to qualified parties interested tn developing new Hh | 
hardware, Service manuals for the HHC and each HHC peripheral ar 


available on the same basis. 


The HHC Keyboard 


The HHC keyboard has 65 positive action keys, 53 of which are rewilily 
usable by application programs. The SHIFT and 2nd SFT keys provide necenk 
io the entire printable ASCII character set and are software-lockable, wit 
of the keyboard keys auto-repeat at a rate controlled by the STP/AMI 
(stop/speed) key. | ened 1d 

All of the kevboard’s accessible keys may be software-redefined (a genet 
ate any 8-bit character code. 


The LCD | 
The LCD displays 26.5 characters ona 159 X 8 dot matrix, bidin re ii 
character displayed withina 5% / matrix, the top row of dots 1s reservea 1 
een esheets software handles character generation, bass - 
define a 256-character alternate character set through software, One ¢ lt , 
defined, an application may select the standard or the alternate chat ri ; 
for each character of output. [he standard character set miky itiso mM 
‘defined by software. | 
prose fat any character from either character set with any combi 
nation of flashing, inverse image, and invisible attributes, _ 
Floating accent marks may be displayed over any characte and may bi 
defined by software, 
rhe LCD's standard cursor may be 
suppressed, | -_ 
Che LCD may be used asa sequential device 1 W 
the left edge of the LCD as they are displayed at the 
devier in which any charaeter may be displayed in any pansion 


software-redelined and may alao be 


hich charnelers rotate otf 
fight, or ax a random 


r 
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You can use t 

Sieg Le sachs = ‘ {59 * 8 dot-addressable graphics device 
used by the HHC’s nit software-controliable, although five of eee — 

ee ae 2 ating system in ways that: a 

applications use. ways that are likely to conflict with 

The “squeaker,” 

er, asound generator: ; 
ai re = ator associated wit! 7 
tone: aR ies with the LC : 
es at 36 different pitches and of any desired duratio anenrere 
, ration, 


Battery Power 


The five TECH: os eee ‘ 
WHC Seb con nickel-cadmium AA size batteries that power th 
fhack = io be permanent; only a service technic i 

ese batteries. ‘ chnician should replace 

Low-powe qa 
ihenahite ie ni ne herals draw power from the HHC batteries 
able batteries that a igher-power peripherals contain their own rechar : 
Adige eet, Sodian AC Adsporthronghthe HC bus, The 

ea: Pp - as no batteries and requires an AC Adaptor to ope et ™ 

ene a XIE: é j rate. 
ones alan renee = conservation, the HHC’s cuneate ag syste 

of hardware interrupts t ae 
ponent only eeateee Ae pts to power each hardware com- 
aie viii hecessary. When an application program 1s aoe 
ae hia ape on the keyboard and the cursor is not flashin : - 
‘igh eee as ae to the LCD and to RAM, but the non CMOS, 
PE Ween Jand all ROMs areturned 

internet GAS me off. Each keystroke gener 

: ea | t turns onthe CPU. After it processes the kevs ee 
urns itself off again. s the keystroke, the CPU 


SOFTWARE 


Most of the HH 
in SNAP, a eras ee and application software 1s written 
pene Coke ariant designed specifically for the HHC. SNAP Is th : 
grams that m — demanding applications—the large, comp! an 
ae ‘ * : » oF 5 a = 
- nust run efficiently and that use many of th MPIEX Pro 
more esoteric features a ¢ operating system's 
A SNAP in 1 
ner ute 4 
the nucleus of hs HEC oe we interprets compiled code, is built into 
compiles source code, 1 : oP eee system. An outer interpreter, whicl 
Conipiled eee e.1s built into the HHC SnapFORTH capsul v_ 
h . i: ; "i + ae + ) C. 
itilent machine ari typically about 30% more compuet than equiv 
reeal eae ie 20 to 25% as fast. SnapPOR TH contains a 302 
machine | paeaie se used to rewrite selected parts oF SNAP a 
‘chine language for more speed : PRO_PAMS In 


see the description of the snap 


The Operating System 
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{information on SN APand SNAP programmers toula, 


For more general 
FORTH capsule in Chapter 5, 


hand VOU [TENN tht 
Perudhiyiityp eM 
pro gran Leap 


When the HHC is powered up with the ALL-OFF switc 
CLEAR key, the HHC’s operating system initializes itself, 
eontral until the ALL-OFF switch is turned off again or until a 
enuses a crash. 

The OFF key does not cause the operating system to 
LHC. In fact, it docs not even turn off the HHC in the 
Rather, software directs the operating system to turn oO 


and CPU. Then interrupts can turn the CPU on again. 
kes extensive use of inte 


rhe HHC’s operating system me 
neripheral 1/O and keyboard 1/O are interrupt-driven. 

A software control block, called an ever! control block (ie 1), manages 
interrupts. The initiating routine assigns an ECB to aneventand, dire tly a 
indirectly, calls the operating systems event handler. After the ever Lined ben 
clears the first byte in the ECB and places the ECB ina queue, the mitt le 
ith its processing or turn the CPU off, 
d with the ECB occurs, it generates an 
ssociates the event with the proper PEM 
order bit in the lirst byte, tle 
event action is apprepritt 
ated by a RAP ( Reauest 
Lyridane 


lose control (lis 
conventionil He dyat 
ff power to the 1 |) 


erupts, aie ult 


routine can continue W 

When the event associate 
lhe interrupt handler 1s executed, a 
and posts the ECB by turning on the high- 
hen take whatever post- 
for example, is initl 
with an ECB as a parnametel 
the initiating routine, whieh candle 


griber re bigye 


initiating routine cant 
A character-input operation, 
Input) call to the operating system 


diately after the RIP, control returns to 
other processing until it needs the character that is being read, When Nie 


routine can proceed no further without the input, “makes a WALT eal te 
ihe operating system, which turns off the CPU if no character In penal 
Whenever an interrupt occurs, the opera urns on the CPU and 
the event manager processes the event, 
arrives, the event managet posts the ECB and returt 
tion following WAIT in the initiating rouuine, 
fhe operating system maintains a S-byte “ime of Century clock" that ts 
based ona 3-byte timer inthe HHC hardware. AL UR’ C the cloel 14 ae Vitale 
io- |S seconds pet month. Over its rated temperature range of 0" ta dd’ Ul 


seconds per month 
y the time of cemlury, 


ting system 1 
When the requested ohana {ea 
is control to the oper 


ig necurate to 28 
Appliention programs cit que! and can also Ket 


Himed delays With VArlotis operating system ealls 
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I/O Operations 


Most [/O operations are performed through a pair of system calls. The 
lirst call initiates the operation—either RIP (Request Input) or ROP 
(Request Output). A second call. WAIT, halts processing until the opera- 
lion is complete. With programs written in SNAP, you can easily programa 
WAT? on multiple ECBs. Thus, you can, for example, wait for the comple- 
lion of an [/O operation on any of several devices. 

/O ts largely device-independent, A system call addresses a device by a 
fogical unit number (LUN) bound to the device at run time, so that a 
program may be written to send output to a Printer, a Modem, ora TV 
Adaptor without concern for which device wil] actually be attached at run 
lime, Physical differences among devices are accommodated by routines 
(hat are located in each peripheral’s device driver capsule. The operating 
system's use of these routines is transparent to the application program. 

Like peripherals, the keyboard and LCD may be manipulated through 
ECBs and LUNs. When device independence is not needed, these devices 
can be addressed with special 1/O operations that are more convenient to 
use, These operations support all of the devices’ special functions—for 
example, special display attributes and dot matrix graphics on the LCD. 

Programs that need line-oriented input may use EXPECT, a very pawer- 
ful line-input system call that supports all the line editing functions of the 
HHC's File System editor. EXPECT not only provides a convenient way for 
i programmer to implement powerful line input, but also presents the user 
with a consistent user interface for all HHC programs that read lines of data 
lrom the keyboard. : 

The operating system maintains a 16-character buffer for the keyboard, 
making it possible for the user to type ahead of any program. Most input 
peripherals have similar buffers. 

[tis possible, though with some restrictions, for a program to redirect 
keyboard input and LCD butput to a peripheral by binding the keyboard’s 
or LCD's LUN to another device. Redirected 'yO cannot support the 
devices’ special functions, and the redirection is canceled the next time you 
press Che CLEAR key, 


The File System 


fhe HHC'’s File system application program is based on a {ie Minn pe- 
ment routine in the operating system that is also feferred (6 aa “ihe File 
system,” 
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The File System routine simulates a random ACCESS file a por 
non-volatile RAM, Application programs can call it to create, aa Arie 
locate files; to read, write, insert and delete records; to compute the amount 
of free RAM in the file space; and for various other purposes. oe 

Files may be stored in intrinsic RAM, extrinsic RAM, or eon i a 
RAM means a Programmable Memory Peripheral or PMI . One es 
urea, intrinsic or extrinsic, is accessible to a program at a time. You sv Heli 
from one RAM area to the other with the 1/0 key or through a program 


Floating Point Operations 

The operating system includes a complete set of system ails warp 
point operations, including the four ATICATAGHEUNGHONS, TOFRUAE . a 
and rounding. The internal floating point format uses a 52-bit, declim ae 
mantissa that provides 13 decimal digits of precision. The range of th 
is approximately 10 +!924, _ , 
The Scientific Caled larot capsule contains the trigonometric deers 
and several other additional floating point operations that ea Be one 7 
library routines if the calling program and the Scientific Calculator capsule 


are in the HHE at the same time. 








Keyboard 
And LCD Codes 


This appendix lists and discusses the HHC’s character set, a collection of 
printable and control characters. The HHC’s character set is an expanded 
version of the American Standard Code for Information Interohanpe 
(ASCII, a standard used by virtually all computers manufactured today 
HHC variations from ASCI!—almost all of them extensions—are shaded in 
ihe tables that follow. 

Since a computer represents all data as numbers, each characte! in the 
H HC character set has a numeric value. This number is used to represent the 
character inside the computer. 

The character set is divided into three major groups, each with separate 
numeric value ranges. — 


Control Characters 


Control characters have control functions such as ringing @ bell os 
beginning a new line on an output device. Control characters have numeri’ 
values from 0 to 31, 
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Table D-1 lists each contro] character w 
key, and LCD symbol, 

‘If a character has no entry in the LCD sy 

displays an inverse Image symbol on the [ 


symbol, add 32 to the numeric value a 
Characters.” 


JA character with an entry inthe LCD symbol column ma 
Invetse Image symbol in certain special output operations. 


ith its numeric value, keyboard 


mbol column, the character 
ECD or TV. To determine which 
nd consult Table D-2, “Printable 


y also display an 


Printable Characters 


Pi iti characters represent such symbols as A, 3, or ! They can be 
oe = On most output devices and entered on most input devices. Print- 
vy aracters have numeric values from 32 to 126 | | 

© printable characters are letters, numbers, Punctuation, and common 


symbols found in English text 
keyboard key. Eso text. Table D-2 lists the numeric values for each 


Unique Characters 


- nei characters are unique to the HHC’s character set. Most unique 
ine soe ae adele: oe that they can be displayed on the LCD 
f - peripneral devices such as the TV Ad ; 
Cen : a . Un 
characters have numeric values from 127 to [42 ptor, Unique 

Table D-3 lists the numeric y 
unique characters. 


Insta 
or = hy ong oe 127 represents the control character “delete” 
» stead of the C’s “insert” cursor, The —k 
iineied cy backspaces the 
cursor and the — key advances the cursor. Neither disturbs the = 


The value [36 represents 


alues and keyboard keys for the HHC’s 


the multiplication operator. 
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Table D-1, Control Characters 


Numeric | HH© Keyboard | HHe LCD ASCII Name 
Value Key symbol and Functlon 








NUL, Null 
SOH, Start of heading 
| STX, Start of text 
ETX, End af text 
EOT. End of transmission 
ENQ, Enquiry 
ACK, Acknowledge 
BEL, Bell. When sent to the L€ 1), 
makes the HHC “beep” 
8 Backspace BS. Backspace. Backspaces curd 
and erases last character writen 
to LCD 


“Wri bw bh — 


ROTATE Bell 


9 HT, Horizontal tab 

10) LF, Line feed 

1] 1/O* WT, Vertical tab 

[2 FF, Form feed 

[3 ENTER New line | CR, Carriage return, [nila a line 
of input or output 

I4 STP) SPD* SO. Shift out 

[5 ST, Shift in 

16 DLE, Data link esenpe 

By i DC1, Device contral | 

18 DC2, Device control | 

19 | DC3, Device control 4 

20 DC4, Device control 4 

Fa NAK, Negative acknowlod pe 

22 SYN, Synchronous idle 

23 ETB, End of transmission black 

24 CAN, Cancel 

25 EM, End of medium 

26 SUB, Substitute 

pz ESC, Escape 

28 FS, File separator 

29 GS, Group separator 

30 RS, Record separator 

4] US, Unit separator 

*Normally these keys have special control! functions forthe HHC. They cannot be read 


trom the keyboard by an application program, 
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Table D-2, Printable Characters 





HHe 


Numerle ee 
ake Keyboard 
Value ' 
Key 


Numeric 


a Exclamation mark 
td Quotation mark 
Aa Pound sign 

Ma Dollar sign 

i7 4 Percent sign 

AR Ampersand 

9 Apostrophe 

dij Lett parenthesis 
dy 2 Right parenthesis 
42 Asterisk 

Ay Plus sign 

Ad | Comma 

45 Hyphen:, minus sign 
dé ‘ Period 

Slash 


Mo GD Ra eee 


Sk Colon 

5 : semicolon 

) less than 
Equal sign 
Crreater than 
Question mark 


Th 


ZZrR-“TOMTMINGSPae"VEA 


=] 

-_ 
= 
= 
er 





HHC 
Keyboard 
Key 


roe Net CY ROD 


“ | 


eS Sa ee Fee 


pa ee ae eo ee Se eS ee 
5 = 


Left bracket 
Rackstash 
Right bracket 
Caret 
Underseore 
Grave accent 


Lett brace 
Vertical bar 
Right trace 
Tilile 





dppenitin 2 Revboard and LOD Carrs 149 


‘Table D-3, Unique Character 
et Snuris HH Keyboard 
Value ‘Key 





-_—+ 


| 


INSERE 


DELETE 


HHC LCD 
Symbol 


P 
M 











The TV Adaptor: 


A Programmer's Guide 


This appendix contains information for programmers who want lo wile 
software for the HHC’s TV Adaptor. 

To understand this appendix you must know how to use a programming 
language and know how programs in that language perform 1/0 on the 
HHC. You must also be familiar with hexadecimal (number bare 16) 
notation. 

The information contained here has not been previously published, 

The TV Adaptor operates in one of five modes. When you attach it to 
your program it is in a/phanumeric mode. In this mode you can clingilay 
ASCII characters on the screen and move the cursor with HAO ours 
control characters, much as if the display were a multi-line LCD, Device 
specific commands can change the display colors and perform editing fot 
other functions. 

The other four modes allow the TY Adaptor to display graphios, Tle 
semigraphic 4, semigraphic 6, graphic 64, and graphic 128 modes differ both. 
in the number and size of the graphic image elements they display on the 
screen and in the types of control they allow you to exerciae over the 
contents of the display, 
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COMMUNICATING WITH THE 
TV ADAPTOR 


If you are running a BASIC program, the device code for the TV Adaptor 
is 67. Before running your program, connect the TY Adaptor to the HHC 
and turn it on with the I/O menu to establish communication with the TV 
Adaptor. In your pragram, use ATTACH to associate a logical unit number 
(LUN) with device code 67, and then write output to the TV Adaptor. 

With PRINT, you have the usual! choice between performing I/O by 
character, with PUT, or by line. PRINT is more convenient for writing 
alphanumeric output, but PUT is easier to use for graphics and for control 
operations that involve outputting nonprintable characters. 


In SNAP 


If you are running a SNAP program, the device code for the TV Adaptor 
is 43H. Before running your program, connect the TV Adaptor tothe HHC 
and turn it on with the I/O menu to establish communication with the TV 
Adaptor, In your program, perform an ATTACH to associate a logical unit 
number (LUN) with device code 43H, and then write output to the TV 
Adaptor. 

You can do I/O in several ways. You can write one character at a time 
with ROP, the HHC’s standard way of doing output. You can also write an 
entire block of ASCII data in a single operation. The block may be any 
length from | to 253 characters. This is an efficient way of changing the 
contents of the display. You set up an ECB as shown in Table E-1] and 
perform an RCTL to initiate the operation. Performa WAIT or WAITM to 
complete it, Writing a block of ASCII data is equivalent to doinga ROP on 
each character in the block, 

You can write a block of raw data directly to the TY Adaptor’s display. 
set up an ECB as shown in Table E-2 and perform an RCTL to initiate the 
operation. Then perform a WAIT or WAITM to complete it. When you 
write a raw data block, you bypass the TV Adaptor’s usual filtering for 
command characters and escape sequences. This method is shghtly more 
efficient than writing a block of data without bypassing the Adaptor’s usual 


filtering. The format of a raw data block is quite different from the format of 


an ASCII data block. Raw data formats are discussed in the next section of 
this chapter. 

You can also read a block of raw data directly from the TV Adaptor’s 
display. First, set up an ECB as shown in Table B-2 and perform an RCTL 
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Table E-1. BCH far Writing @ Hloek of ASCH Data 





Byte Contents 
0 lratfie byte 
( Set to0lH 
2 Set to length of block in bytes (1 = nS 253) 
3ta2+n Data bytes 0 through n-| 





Table E-2. ECB for Reading or Writing a Block of Raw Data 





Byte Contents 
0 Traffic byte 
! Set to 2 
Z Specifies the number of RAM pages to read from the 


video display RAM into the buffer or to write from the 
buffer to the video display RAM. ARAM page is LOOM byten 
iong. Use a positive value to read; use a negative value 
to write. 

3adg Address of the buffer that receives the data (for 4 
read} or contains the data (for a write), 


—=—- = —— 





{0 initiate the operation; then perform a WAIT or WAITM to complete i 
Youcan read the TV Adaptor’s configuration parameters, Setupan lt B 
as shown in Table E-3 and perform an RCTL to initiate the operation 
Performa WAIT or WAITM tocomplete it. All fields following 0 and 1 ate 
filled in, and initial values, if any, are lost. 
All possible ECB return codes are standard device-independent ona witht 
values 0 to 6. 


ALPHANUMERIC MODE 


When you attach the TV Adaptor to your program, tt runs in aly 
numeric mode until you shift it to another mode with an, escape sequent 

In alphanumeric mode the display consists of 16 lines, each 4? oohitine 
wide, In cursor positioning operations the lines are identilied by niimhere 
from 0, at the top, to 14, or OF H, at the bottom. The columns are uleniittedl 
by numbers from (), at the lett, to 31, or JFH, at the right. Pach elnranter 
displayed with ab K © A matrix ina 12 * 8 cell, 


] 4, flee FedEC Caer Gheaitedy 


Table Ee3, PC for Reading TY Adaptor Configuration Parameters 


Hyiec Contents 
lh lrattic byte 
Set tod) 
2 A position of cursor, In alphanumeric mode, by 
character, in semigraphic and graphic modes, by 
pixel 
4 ¥ position of cursor, by character or pixel 
4 Control nybble at cursor position (see section on “Raw 
Data") 
5 Data byte at cursor position 
if Currently selected page (alphanumeric and semigraphic 
modes only) O=page |; l=page 2 
7 Delault character 
5 Control flags (meaningful only in alphanumeric mode} 
See Table E-7 
9 Default control byte, as set by SETPRMS 
OA Current mode (alphanumeric, semigraphic 4, and so on) 


Meaning is the same as for the SETMODE escape 
sequence, see Table E-7 

Of Vertical measure of display, In alphanumeri¢e mode, in 
lines; in semigraphic and graphic modes, in pixels 

UC Horizontal measure of display, in lines or pixels 





The PV Adaptor maintains two pages of memory designated “page | and 
“page 2.” Fach page describes one screenfull of information, At any time, 
one of these pages is selected. Thus, output to the TV Adaptor affects its 
contents, and its contents are displayed on the screen. Page 1 is automati- 
cully selected when the TY Adaptor is first attached. 

A program can select either page at any time, thereby enabling it to flip 
back and forth between two different displays by writing a single control 
sequence. 

fhe TV Adaptor initially displays data with certain default attributes. 
However, you can change them with appropriate control operations, Data 
churneters you send to the TY Adaptor are displayed in green on a black 
background, When the display or part of the display is erased, each affected 
position is filled with a blank, the default character, After displaying a 
character, the TY Adaptor moves the cursor one column to the right, 

Alter displaying a character in the last column ona line, the TY Adaptor 
moves the cursor to the first position of the next line down, This in called 
auiiomiatle line feed. 
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When you attempt to move the cursor down from the last line of the 
display, the TV Adaptor serolls the entire display up one line. The forme! 
lop line 1s lost, and the bottom line is filled with the default character, a 


»- blank. This is called automatic scrolling. Word wrap is on, and the word 


delimiter is the “blank” character. 


Haw Data 


Several of the TV Adaptor’s I/O operations involve raw data. In order to 
handle raw data you must first be familiar with the way the TV Adaptor 
stores display information in alphanumeric meade. 

The TV Adaptor stores display information in RAM that is addressed 
only by the TV Adaptor’s device driver. There are 4K of this display RAM ta 
klore two pages. 

Fach page of the display RAM consists of 1024 pairs of bytes. Each pair 
stores information about one position on the display. The pairs are stored in 
RAM in English reading order: the top line from column 0 to column 31, 
then the second line from 0 to 31, and so forth. 

The first, even-addressed byte in each pair is the contro! byte. This byte 
contains information about how data is to be displaved. The second, odd 
nddressed byte 1s called the data byte, and it contains information about 
what is to be displayed. The format of each byte depends on the current 
display mode. 

The format for a pair of bytes in alphanumeric mode is shown in JTable 
l'-4, where 0 is the control byte and | is the data byte. 

When an ASCII data byte is written to the display, the TV Adaptor’s 
control routine translates it into a pair of bytes that is stored in the display 
RAM. The current foreground color, invert mode, and flash mode are used, 
Ihe 8-bit ASCII data byte is translated into seven bits of raw data, an 
“Internal/external” bit and an “invert/no-invert” bit, as shown in Table E-5. 


l’oreground and Background 


Many of the video display operations deal with “foreground” and “back- 
pround” attributes of the display. “Foreground” refers to the attributes of a 
character or graphic display element written to the screen. “Background” 
refers to the attributes of the rest of the screen, 

l'or example, when the screen is cleared, the entire display is given the 
background attributes. Similarly, when a line feed in alphanumeric mode 
makes an empty line appear at the bottom of the screen, the empty line Is 





Table Ee, Structure of a Display RAM Byte Pair Representing One 
Lysplay Position in Alphanumeric Mode 


Wyte «= Eis Meaning 


{) Control Byte 
KO. 10) Unused (actually not supported by hardware} 
Ok (} = no flash, | = Mash 
(a Unused 
02 () = use Internal character generator; 
| = external 
Oi Color: 0 = display green or black; 


] = display orange or yellow 
Data Byte 


H() Color inversion: 0 = display green or orange, 
] = display black or yellow 
40-0] Data 























0 = No Invert 
1 = Invert 


0 = Internal 
1 = External 


ASCII 


| (‘haracter 
dace Value 











a a 00H = 1FH 
blink -_. | 20H -5FH f= ASCH - 20H 


Le end 60h - OOFH = ASCII - 60H 


shown with the background attributes. When a character is written to the 
sereen, itis shown with the foreground attributes, 

Asanexample, ifthe background color is green and the foreground color 
ik Orange, the display will show orange characters on a green background. 


Types of Output 


Phe TY Adaptor recognizes (and treats differently) several types of 
Crt pPUe, 

Printable characters, which are most of the characters from 20H up, are 
(rented as data. Each data character written to the TV Adaptor displays one 
character on the screen in alphanumeric mode or one group of picture 
elements in any of the graphic modes 

Nonprintuble charneters, whieh are OLT or LPH and the eurser control 














characters (80H to 83H), are treated as control commands. Each valid 
control command performs a control operation on the TV Adaptor. These 
operations include carriage return, cursor movement, and inserting or delet- 
ing lines on the display. 

Many control commands must be followed by one or more operands. 
Each operand is a byte of data that influences the way the contro] command 
is performed. Operands that specify numeric quantities, like the line and 
column numbers in a cursor positioning command, are always expressed in 
binary form. The three-byte sequence of binary values “29 10 12” puts the 
cursor in column 10, line 12. 

Control sequences that begin with code 27 (1BH or ESC) are called escape 
sequences. These sequences set various configuration parameters of the TV 
Adaptor and, inthis way, affect the display indirectly. Some escape sequen- 
ces are device-independent. These are discussed in the chapter on peripheral] 
1/;O inthe SNAP Programmer's Reference. 

Every escape sequence consists of 


1. Control code 27 (1BH or ESC) 


2. A one-byte binary opcode, which determines the function of the 
sequence | 
3. One or more operands, which influence the way the operation 1s 
performed. The value of the opcode determines the number and mean- 
ing Of the operand bytes. 
At least one operand byte must always be present. In escape sequen- 
ces that do not use any operands, the operand byte is ignored. 


Character Generators 


The TV Adaptor generates alphanumeric characters from patterns stored 
in two special ROMs called character generators. 

The internal character generator produces ASCII characters 20H 
through SFH, which are numerals, capital letters, and most special 
characters. It is permanently installed in the TV Adaptor. 

The external character generator produces ASCII characters 60H 
through ODFH, which are lower-case letters, Japanese Katakana charac 
ters, and some other special characters. It may be replaced by a custom 
programmed EPROM, making it possible to change this part of the TY 
Adaptor’s character set. 

The standard pair of character generators conforms to HHC Extended 
ASCll except that character 96 or 60H, the grave accent, displays as a blank, 
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Control Commands and Control Sequences 


lable Ee lists control commands and control sequences for the TV 
Adaptor, 

The column labeled “symbols” lists words that are used to refer to the 
contro: commands in the text. Some of these words are predefined te 
represent the control commands in SnapFORTH., Others may be defined in 
your program with the symbolic constant word,“= =", 

The symbol “@" represents the cursor: the cursor’s initial position Is 
(A,Y), Ina multicharacter control sequence, the first character, the control 
character, is “e.", The second character ts “Cs and so forth, 

lable E»7 lists the SEFMODE escape sequences for the TV Adaptor in 
ilphanumeric mode. 

The “symbol” column in Table E-7 has the same significance as it had in 
lable B-6, but i refers to the second character. the opcode, rather than to 
the first character, which is always ESC, The “operand bytes” column gives 
the number of operand bytes in the sequence. An “x” means that the 
wequence has no operands. The opcode must be followed by one operand 
byie, whose value is ignored. In the “mea ning” column, the first operand is 
denoted by “p,”, the second by “p,", and so forth. 


SEMIGRAPHIC AND 
GRAPHIC MODES 


You enter any of the semigraphic and graphic modes by issuing the 
SETMODE escape sequence from alphanumeric mode or from anothe 
graphic or semigraphic mode, 

lable E-& summarizes the characteristics of the graphic and semigraphie 
miacdes, 

[he semigraphic modes support two display pages, just as alphanumeric 
mode does, The graphic modes support only one display page and use all af 
(he TV Adaptor’s display RAM to give a high-resolution display. 

Alphanumeric, semigraphic 4, and semigraphic 6 data can be intermixed 
lreely on the display. Graphic 64 or graphie 128 data must be displayed by 
acl! these modes may not be mixed with alphanumeric of scmipraplie 
modes of with each othes 

Inany graphic or semipraphie made, the display conaints Of a prid pattern 
of picture elements called pively, Pixels are grouped inte larger elements 
balled pixel matrives, whieh also form a grid pattern, In easeh mode, the 
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Table E-6. Control Commands in Alphanumeric Mode 


Decimal 
Yalue 


4 


0) 


baa 
| 


At} 


A| 


| 2k 


129 


) Att 


Hex 


Value 


Ct 


Y 


BU 


Bie 


83 


Symbol 
BACKSPACE 


HEAB 


Ir 
CLEEQIP 
FORMFEED 


wk 


DL) PLi 


LSe 


POSCLER 


IDATA 


AYD 


de [! 


ce [ 


Control 
sequence 
Length 


Varies 





Meaning 


Replaces the character at (M-1, ¥} with the 
cetauit character (usually “blank™) and 
moves i to (A-EY}. 

Moves @ right to the next tab stop. Ef aw 
lab stops are set 1o the right of column %. 
moves f@ to (31 Y). (Tap stops are set and 
Cleared with escape sequences, } 

Moves @ to OS ¥Y4+1). If @ ts at (4,15), the 
display is screlled or erased. 

Fills the display with the detaull character, 
beginning at (X,¥} and ending at (31,15). 
Moves @ ro (0.0). The entire display ts 
filied with the default character. 

It automatic ling feed is enabled, moves (a 
to (O. Yo )) ud ts at (X13), the display is 
scrolled or erased. HW automatic line feed is 
disabled. moves t@ to (OV). 

Copies the character displayed at (A.V) 
to (X.Y). WH Y=O. comes from (X_1 5). 
Begins an escape sequence. Followed by an 
opeode and one or more operand bytes. 
isee Table E-7 tor infarmation about 
escape sequence opcodes and operands. 4 
Moves @ tote. ¢.). Does not affect the 
contetits of the display. 

G is interpreted as a raw data byte with the 
current default gontral byte: it is displayed 
regardless ol whebher ot tit it is a data 
character. Noale Ihat the symbol a raw dala 
characler displays is not the same as the 
one it represents in HH! extended ASCH 
nalation. (Se the text, Tabie C-4, and 
Figures F-? through L-4 for more 
informatie. } 

Moves (0 ta (c..c,}, displays ¢, as raw 
data, and moves @ forward for backward} 
one character im the usual manner. (dee 
IDATA for notes on raw data.) 

Moves @ up to (MX. ¥-13. Tf is at (X0), 
serolls che display down one line; ine Oss 
filled with the default character 

Moaves t@ left to(X-].¥). lt is at Q,y¥ 
moves it to €3E,¥-1h Unhke BACK- 
SPACE, does not modify the display. 
Moves (@ right to(X+].¥). It is at 
(31,.¥), moves it to (O.¥+1). Unitke “blank,” 
docs nat modify the display. 

Moves (@ down to dS. ¥+)). 1 @ ts at 
(X.05), scrolls the display up ane line; Hine 
fh is filled with the default character. 





— 





Table E-7. Escape Sequences in Alphanumeric Mode 


Decimal 
Value 


G 


Operand Default 


Hex 
Value Symbol Bytes Value Meaning 
00 SETCTRL i 86H = Each bit of p, sets one config- 
uration parameter. Note that 
many of these parameters 
can be set separately with 
other escape sequences. 
Bit Value Parameter 
0 80H Same as SETCLEOP 
2 20H Same as SETTRANS 
3 IQH = uninvert foreground color: 0 = invert. 
Same function as SETINV and UNSETINY 
4 08H |= enable foreground flash; 0 = disable, 
same function SETFLASH and UNSETFLH 
5 04H Same as SETSCRL : 
6 O2H Same as SETLEF 
7 OQIH Same as SETCOL 
Ol SETLF | | | = Enable automatic linefeed 
on CR: 0 = disable. 
D2 SETSCRL i ] ! = Enable automatic scrolling; 
0 = when @ tries to move down | 
from (X. 15), it is moved to (0,0) 
and display is filled with default i 
character, 
03. SETBACK I 0 1 = write backward (cursor 
moves left after a character is | 
displayed, and wraps up); | 
Q = write forward. 
04 SETCLEOP I ] ! = enable clear display to end 
of page on LF: 0 = disable. — 
05 SETPAGE l 0 0 = select page 1; | = select | 
page 2, 
06 SETMODE ] 0 Select display made: 
0 (00H) = Alphanumeric 
4 (04H) = Semigraphic 4 
6 (06H) = Semigraphic 6 
64 (40H) = Graphic 64 
128 (80H) = Graphic 128 
OF SETPRMS - | 0 Sets background display 


parameters. Fach bit in the p, 
sets one parameter. Note that 
many of these parameters can 
be set separately with other 
escape sequences, 


Table E- J, Paoape Sequences in Alphanumeric Mode (Continued) 





























Decimal! 
Value 





a 





Hex Qperand Default 
Value Symbol Bytes Value Moeanlng 
Bit Value Parameter 
G BOH Bits 80, 40, 04, and 02 determine the current diaplay 
mode, Their functions and values are the same aa 
SETMODE. “OR” other required bits into these 
values. 
I 40H See bit 80H 
p. 20H Not used; should be 0 
3 IOH Same as SETPRINY 
4 O8H Same as SETPRFLH 
5 04H See bit 80H 
6 02H See bit 80H 
- Q1H Same as SETPRCOL 

08 SETPRCOL ] 4) Background color, S14 
PRINY = 0, then | © oraiipe 
O = green. ET SETPRINY © | 
then 1] = yellow, 0 © MMieh 

09 SETPRINV ! 0 Invert background color dee 
SETPRCOL., 

OA SETPRELH | () ] = enable background (lial 
O = disable. Background altes 

et nates between its regular mn 
inverted color. 

0B SCRCOL I — Sets the entire display ta a 
specified color, Both larepraivnd 
and background are allected 
i = orange: 0 = green 

oC SCRINV l — Sets the entire display (6 i ajies 
ified invert mode, Both far 
ground and background ar 
affected. | = invert enabled. 
= disabled, 

QD SCRFLH l Sets the entire display ta a aye 
ified flash mode. Both fare 
ground and background ar 
affected. | = flash enabled) 
Q= disabled. 

0E SCRLUP l — Scrolls entire display uj fi, lies 


The vacated lines are filled) with 
the default character, 
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Table E-7, 


Paoape Sequences in Alphanumeric Mode (Continued) 





fable E-7. Escape sequences in Alphanumeric Mode (Continued) 





Decimal Hex Over | Decimal Mex Operand Default 
; Perand Default 7 . | Mp 
Value Value Symbol Bytes Value vienna Value Value Symbol Hytes Value Meaning 
i OF SCRLDN i — scrolls entire dispiay down p 28 IC) 6CHRINV [ sets part of current display ta 
lines. The vacated lines are ae the current foreground invert 
with the default character. mode (see SE PINY), p, olarai 
lé 10 «=SCURX - A ters are allected, bepinning at 
7 ih @ horizontally to (X,Y) and extending toward (he 
17 11 SCURY Se ae Da: end of the display, 
! a . | 
18 12 CURRT moves (a) vertically to line Po: 30 fE FLIPINY l Reverses invert mode af part if 
s a x Bs Moves @ horizontally to (31,¥). current display (see SETINY) 
13 SETTAB | « . thar: sare affected 
= Sets atab s Pp, CnNaracters are airected, 
20 l4 CLRTSTOP i SE SUD beginning at (X,Y) and extend 
2 en — Clears tab stop at column Py: ing toward the end of the 
IS CLRTABS x = Clears all tab stops. display. 
22 16 SETBYTE 20H Sets ASCII default character to p,. = ue EE EGOE Reverses color of SUCRE iE 
23 {7 FILLCHRS ! — Sets part of current displ play (see SETCO! }) Py SHANA 
_ so) ee ters are affected, beginnhig at 
the current default character 
(A,Y) and extending toward ti 
(see SETBYTE). p, characters a 
ee 0, end of the display, 
are affected, beginning at (X,Y) 
and extending toward the end of | 64 40 DUNESC No-operation. All PLEIC ilevires 
‘ the display. | other than the TV Adiyitiy ite 
aA [8 FILLINES | — Sets part of current display to play or print p, as thoupl i had 
the current detault character been written as an ordinary data 
(see SETBYTE), p, dines are byte: thus, it can be used ta 
affected, beginning at @ Nee insert “except on TV" data into 
extending toward the Baten of a common data stream hein 
the display, and ending at the wrillen to several devices 
end of the line p,-1 lines below 65 41 EOSINSERT Inserts ASCII character p, a 
25 I9 F : @. (%,Y). The rest of the display Ia 
: FILLSCR j —— sets entire display to the ASCII displaced to the right, The lit 
character p,. character of each line is cin 
et fA CHREFLH 1 = Sets part of current diepiayhe placed to the next line, The 
the current foreground flash character at (31,15) is lost 
mode (see SETFLASH ; 66 42 EFOSDELETE Deletes character at (X,¥), Thy 
UNSETFLH). Pp, characters are rest of the display is diapladed (0 
affected, beginning at (X,¥) and the left. The first character of 
extending toward the end of the each line is displaced to the 
; display. preceding line. The position at 
a? fH CHRCOL l _ Sets part of current display to (31,15) is Alled with the default 
the current foreground color character, 
Wee SETCOL), p, characters are 67 44° SPETINY Inverts foreground color, See 









affected, beginning at (XV) and 
CALONdINE toward the end af 
the diaplay 





SETCOL, 
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Table E-Z. Ewxcape Sequen 


Dbeciiial 
Value 


fii 


hy 


i) 


A 


1 
75 


if 


ii 


fy 


KU) 


Hex 


Vulue 


da 


4A 


4h 


4} 


50 


Pare Ceigtide 


Symbol 
UNSETINY 


SE TPLASH 


UNSE TELE 


SETTRANS 


ChHOME 


WRREAK 


SETCOL, 


FOLINSER 


FOLDELETE 


INSLINE 


DELLINE 


ees in Alphanumeric 


ennai 


Operand 
Bytes 


x 


K 


Default 
Value 


20H 


x! 


| 


Mode (Continued) 


Meaning 


Uninverts foreground celor. 


Enables foreground flash. Fore- | 


ground thps between its regular 
and inverted color. 


Disables foreground flash. 


| = display control commands 
as data; 0 = execute control! 
commands as usual. 


Moves @ to home position, (0,0). 


sets ASCII delimiter character 
for word wrap feature to D,,. 
Py = OF FH disables the feature. 


Sets foreground color. If iore- 
ground color is inverted (see 
SETINY and UNSETINY}, 
then | = orange, 0 = preen, If 
hot, then 1 = yellow, 0= black. 


Inserts ASCII character Dy at 
(4, VY). The rest of the line is 
displaced to the right. The char- 
acter at (31,3 is lost. 


Deletes character at (X,Y). The 
rest of the line is displaced to 
the ieft. The position at (31,¥) is 
filled with the default character. 


An empty line (filled with the 
default character) is inserted in 
the display at line Y, 

Ifp, = +1, lines 1 through Y 
are moved up one line: line 0 is 
last. 

ifp, =—i, lines ¥ through i4 
are moved down one line: line 
[3 (the battam line) ig lest. 


Line ¥ is deleted from the dis 
play, Hop, equalnl, Unew o 
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sequences in Alphanumeric Mode (Continued) 


Table E-7. Escape 


Decimal Hex Operand Default 
Value Yalue Symbol Bytes Value Meaning 


through Y-! are moved down 
one line, and line 0 is filled with 
the detault character. 

If the operand p, equals ~1, lines 
¥+ 1 through 15 are moved up 
one line, and line 15 is filled 
with the default character. 

$2 St MULDATA Varies — Displays one or more raw data 
bytes. p, indicates the number 
of raw data bytes given. Each 
following byte contains one raw | 
data byte. The display begins at 
(X,Y) and proceeds in the cur- 
rent direction of cursor motion, 
wrapping at line boundaries in 
the usual way, 

83 23 SVCTL | — Stores p, into the control byte 
representing position (X,Y) and 
updates the display. The data 
byte at (X,Y) is not changed. 
The cursar moves in the usual 
direction. 

84 54 SVDATAS__ l — Stores p, into the data byte at 
(X,Y) (.e., displays it as raw 
data}, The control byte at (X.Y) 
is not changed, The cursor 

moves in the usual direction. 


dimensions of a pixel matrix, measured in pixels, are fixed. The dimensions 
of the display, measured in pixels or pixel matrixes, are also fixed. 

Every pixel on the display has a Cartesian (X,Y) coordinate. Pixel rows 
are numbered from the top of the display to the bottom, the top row being 
number 0. Pixel columns are numbered from the left of the display to the 
right, the leftmost row being number 0. You control the cursor by moving it 
to a pixel with a specified coordinate. 

There are two ways to display graphic information: in pixel made and in 
matrix mode. 

When you write data bytes to the TV Adaptor, you are in pixe/ mode, In 
this mode, each data byte turns an individual pixel on or off and determines 
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Pable E-8, Summary of the Characteristics ot semigraphic and 
Graphic Modes 


————— 


Sercen Screen . 
Size pape | Notes 
{Pixeis) nee 


Mode | Size Matrix 
(Matrices) mize 


Nenigriphic 4 l6 x 32 | 32 64 Any pixel on ar off: 


one color’ matrix. 


Sormigraphic 6 16 X 32 48 & 64 Any pixel on or off: 


one color! matrix, 


Ciraphic 64 bd X [6 64 & 64 | All pixels on: 


Ciraplic 128 64 & 16 64 128 ‘Any pixel on or off; 


one color/ matrix, 


It colof, When you write data with the control command IDATA or with 
the escape sequence MULDATA, you are in matrix mode. In this mode 
cach byte affects all the pixels in a matrix. 

Pixel mode is easier to program and is considered the normal mode of 
displaying graphic information, Matrix mode is more efficient and can 
display data more rapidly. 


Writing Data in Pixel Mode 


Phe TV Adaptor recognizes the same three types of output in semigraphic 
modes as in alphanumeric mode, but it defines the three types somewhat 
differently, 

Hinary values OOH through O8H are considered pixel mode data. Each 
lata byte sets the pixel at the cursor to a specified color or turns it off. 
Writing a pixel affects the other pixels in the same pixel matrix in a manner 
dependent on the current mode. 

Attera pixel mode data byte has been written, the TV Adaptor moves the 
cursor One pixel in its current direction of motion. The cursor does not wrap 
when i has reached its limit of motion in any direction, nor does the display 
¥croll 

Binary values greater than O8H are either control commands. as listed in 
liable E-9, or are ignored, 

lable b-9 lists control commands for the TV Adaptor in semigraphic and 
praplic modes, The symbol “@" represents the cursor, and (X,Y) 1 epresents 
the cursors position, All addressing is done by puma] ers é 


any pixel any colar. | 
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Table E-9. Control Commands in Semigraphic and Graphic Modes 


Decimall Hex Control ; | 
Value | Value Ss¥ymbal Sequence Meaning | 
alle Wie Length _ 


OF IMOVECUR Moves cursor one pixel in its current 
direction of motion. The display is not 
changed. 

Set cursor direction to “up.” 
































































IGO.UP 
'GO.BACK 
GO.FORW 
GO.DOWN 
GO.UP,BACK 
GO.UP.FORW 
GO.DOWN.BACK 
GO.DOWN FOR W 
CO NOWHERE 
DRAWTLINE 


Set cursor direction to “left.” 
Set cursor direction to “right.” 
Set cursor direction to “down.” 










Set cursor direction to “up and left.” 

Set cursar direction to “up and right.” 

Set cursor direction to “down and left.” 
Set cursor direction to “down and right.” 
Set cursor direction to “stay in place,” 
Draws a line from @ to coordinate(c,, c,). 
The line is one pixel thick. Its color 1s de- 
termined by c, (see Table E-[1 for the color 
each value of c, produces). The cursor 

is left at (c,, ¢,). 

Begins an escape sequence. Followed by an 
opcode and ane or more operand bytes. 
(See Table E-10 for information about 
escape sequence opcodes and operands.) 
Moves @ to coordinate (c,. c,). Does not 
affect the contents of the display. 

Writes c, to the data byte representing the 
pixel matrix at @. The corresponding con- 
trol byte is set ta the current default, as set 
by SETPRCQL or SETPRMS. (See text 
for more information. } 







Waries 






POSCUR 






IDATA 


Maves @ to coordinate (c,, ¢,), writes c, to 
the data byte representing the character dt 

@, The corresponding control byte ts set to 
ithe current default, asin [DATA. The cur- 
sor moves one pixel in the current direction. | 


Table E-10 lists escape sequences for the TV Adaptor in semigraphic and 
graphic modes. The “symbol” column has the same significance as in Table 
E-I1, but refers to the second character, the opcode, rather than to the first 
character, which is always ESC. The “operand bytes” column gives the 
number of operand bytes in the sequence. An “x” means that the sequence 
has no operands; the opcode must be followed by one operand byte, whose 
value is ignored. In the “meaning” column, the first operand is denoted by 
“p, the second by “p ,” and so forth. 


mendie 2 THe oe eeepeer 4 age 
Lou lia HAC) Liver Gite A pipnerrecdi r 


‘cred in Table E-11 
rT ! one ! — aAlic are listed in Table E-11. 
Table Ee lO. Escape Sequences in Graphic and Semigraphic Modes n semigraphic 4 mode a 


ata byte functions | eas Sax ee a , aoc 
“tn turned on, the other “on” pixels in the same pi 


Live dyin Hex 













) cana eee xe] is 
Symbol Operand | Default Ataanlng Whenever a pike enelee 
Value Value Bytes Value . matrix are set to the same co On . are shown 10 Table E-12. 
a3 | - | | Data byte functions in semigraphic 6 areas ‘sels in the same pixel 
4 ()S SETPAGI | () O = select page |; | = select a era pixel is turned on, the other “on plxels l | 
page 2. {Meaningful only in Whenever a Pp lor 
semigraphic 4 and semigraphic 6 matrix are set tc the same a ae ROM causes color changes. 
Micka As of this writing, a “bug” in the TV Adaptor Sh bits change as follows: 
b 06 | SETMODE | ( Select display mode: C. aixel is turned off, the colors of the other “on” bits g ae 
0 (0OH} = alphanumeric il a pix eh }] w becomes cyan, blue becomes magenta, a he, 
4 (04H) = semigraphic 4 green becomes bull, yelto + «his problem if you write all of the “off 
6 (06H) = semigraphic 6 becomes orange. You can avoid this oe ae 7" 
64 (40H) = graphic 64 ; ¢ ‘ou write the “on pLxels. 
: , “lc ina matrix before you W! 
128 (80H) = praphic £28 pixels in a matr 
7 0? SETPRMS | | Varies | See descnption of SETPRMS 
with | for alphanumeric mode F 
h "Ts 2 ae , : E 7 | é 
SH ae ; : Table E-11. Data Byte Values in Semigraphic 4 Mo 
H (}H SETPRCOL | iv) sets the I's bit in the default ” cal Mode) 
control byte value, The signifi- (Pixe 
| cance of this bit varies with cies 
. pty nd Sets It to Color 
mode. (See Figures E-1 through Data Byte Value Turns Pixel A eciet 
E-4,) 0 On ¥ cae 
. . e 
fel At) ; DUNESC I —— No-operation, All HHO devices | On Blue 
| other than the TY Adaptor dis- 4 On Red 
play or print p, as though it had : On Butt 
been written as an ordinary data A On Cyan 
byte: thus, it can be used ta 5 On ee cs 
insert “except on TV” data into 6 On agente 
| acommon dala stream being 7 On Orange 
written to several deviecs. 8 Oft (None) 
fa 44 |CHOME x 





Moves @ to home position, (0.0), 
K | 5 | FILLGRAFP | — | The entire display 1s filled with j 
I : } 
p,. interpreted as a data byte 2 
(see Figures E-] through E-4). | 
Every control byte is set to the 
default control byte. 
Ke 52 MULDATA Varies — | Outputs one or more data bytes. 
p, tadicates the number of data 
bytes given. The equivalent of a 


Table E-12. Data Byte Values in Semigraphic 6 Mode 
(Pixel Mode) 











‘OL= bi ; f Sets It 
lf SETPROCOL=1, If SETPRCOL=1, Turns And Sets 


he Pixel to Color 
[DATA is performed for each Data Byte Value pea QO Green 
data byte in turn. 4 Q a Yellow 

= 1 Th . 

Ks 33) OJ SVCTL | — Writes p, ta the contro] byte tor . s L On Blue 
the pixcl matrix at @, The 6 2 On Red 
cursor moves mls current 7 3 0 Buff 

| direction. 0 : re Cyail 

Kal 5d SVDATA | — Writes py, ar Cle clattan hyie lar | | | 5 On Magenta 
(he pixel male ata, p. is the 2 : On Orange 
dat byte, Pie Cursor moves in 3 None} 
iH CUETO tired tien g bo Off ( 
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Latin byte functions in graphic 64 mode are shown in Table E-13 
The eight possible colors are divided ‘Hj 
blue, and red) and 4-7 (buff, cyan. mage 
la turned on, the other “on” 


into two ranges: 0-3 (green, yellow, 
: | nta, and orange). Whenever a pixel 
wt ‘i | pixels in the same pixel matrix are shifted into 
le SAME Tange, For example, if a matrix contains bulf pixels and a yellow 
pixel is WI ten, the bulf pixels (color 4) are changed to green (color 0}. But if 
eyin pixel is written, the bu {{ pixels are not affected, because cyan (color 5) 
i¥ in the same range as buff (color 4), | 
Data byte functions in graphic 128 mode are shown in Table E-14 


Table E-13. Data Byte Values in Graphic 64 Mode 
(Pixel Mode) 







[ff SETPRCOL =1, jf SETPRCOL = 0 Sets Pixel 
Data Byte Value Data Byte Value to Color 
: 0 Green 
: l Yellow 
: 2 Blue 
; 4 Red 
: 4 Bulf 
: 5 Cyan 
: 5 Magenta 
: 7 Orange 
a 


Equivalent to 4 





Table E-14. Data Byte V 
(Pixel Mode) 


alues in Graphic 128 Mode 





IFSETPRCOL =1, Hf SETPRCOL = 0, Sets Pixel 


And Sets Rest of 


Daty ee Value Data Byte Value to Color Matrix to Color 
; ; Black Green 
- ; Green Black 
, : Black Hull 
Be ‘ Bull Whack 
4.7 Equivalent te Qe4 


Cquivatent to 


a 
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Writing Data in Matrix Mode 


You write data in matrix mode with the controlcommand IDATA, which 
writes a single data byte, or with the escape sequence MULDATA, which 
writes multiple bytes. 

When you write data in matrix mode, each data byte changes the contents 
of the entire pixel matrix containing the pixel at the cursor. Then the cursor 
moves one matrix in its current direction of motion. 

The format of a matrix mode data byte in each semigraphic mode 1s 
shown in Figures E-1 through E-4. 


Display RAM in Semigraphic 
And Graphic Modes 


Semigraphic and graphic modes use display RAM as alphanumeric mode 
does: RAM is divided into two-byte units, each unit staring information on 
one pixel] matrix. Ineach unit the first byte is a control byte, and the second 










Bit Assignment in Byte Pair 
Control Byte Data Byte 


SER SeE PS) BEE pape 
| : | 10 


x 
ga 40 20 10 G8 04 02 O1 so 40 20 08 04 02 O1 








a 






screen Map 
of Matrix Byte and Bit Contents 


C&O - COR Unused 
CO4 - CO2 1G indicates semigraphic 4 mode 
Col Unused : 
D&O Unused 
D40-D10 — [ndicate color of all “on” pixels in this matrix. An 
“off” pixel is black. 


O00= green 100= buff 
O01= yellow 101 = cyan 
a10= blue 110=> magenta 
O1t = red 11] = orange 
Data bits, A “1]“ turns on the corresponding pixel, 
















DOs - DO! 







ee 


Figure E-1. Structure of a display RAM byte pair representing 
one pixel matrix in semigraphic 4 mode 
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Bit Assignment in Byte Pair 


Bit Assignment in Byte Pair 


Control Byte Data Byte 


SUSCeT RIESE 


Control Byte 





aro 





SBESP OPE] Ebs[=[a[alafo 





BO 40 20, «10 OB 0d 02 OY SU 40 20 10 O8 04 02 O! 80 40 20 10 O8 04 02 0] 80 40 20 10 O08 04 02 OI 
méreen Map 
of Matrix Byte and Bit Contents Screen Map 
C80 - COR Unused 1 | of Matrix | 
CO4 - C02 | | indicates semigraphic 6 mode d? d6 d5 d4 d3 d2 dl! do 





CO! First bit of color specification. See D80-D40. 

DRO - D40 Remainder of color specification. Indicates color of 
“on” pixels in this matrix. The meaning of each 
value is the same as in semigraphic 4 mode. An 
“off pixel is black, 





Byte and Bit Contents 


C80 - C10 Unused 
CO8 - C02 0 1 QO indicates graphic mode 








a COl Determines color of each pixel if “on” 
Figure E-2. Structure of a display RAM byte pair representing | O= green 
one pixel matrix in semigraphic 6 mode i = buff 


D&80-DOI “I” means the corresponding pixel is “on,” An “off” 
bit is black. 





Bit Assignment in Byte Pair | 
Figure E-4, Structure of a display RAM byte pair representing 





Control Byte Data Byte one pixel matrix in graphic 128 mode 

Ss PP PES) | 
KO 640 20 «10 OR O04 02 OF 80 40 20 10 O08 04 0? Of | 

Screen Map | byte is a data byte. Consecutive pairs of locations in RAM represent the 

Of Matrix Hyte and Bit Contents pixel matrixes on the display in English reading order. 

| d | d2 di do] C80-CIO Unused | When you write a data byte in pixel mode or in matrix mode, the control 

— CO8-CO2 01 0 indicates graphic mode byte of the affected matrix is set to the current default value, which may be 

ie sess ea ee neenee ney | changed through the escape sequence SETPRCOL or SETPRMS. When 

Dk0 - D40 Rentals of color eocsiention for d3. | you write raw data, of course, You set cach contro] byte along with the 

lhe value of the 3-bit sequence “cs,c3t,cdu” | corresponding data byte, as in alphanu meric mode, 


determines the color of d3, The meaning 
of the yalue is the same as in semigraphic 
4 mode, 
20» D10 same as D80-D40, for d2 
DOK = Ded same as DXO-D40, for d | 
D0? = PO] same as DRO-D40, for dt 





igure E-3, Structure of a display RAM byte pair representing 
one pixel matrix in graphic 64 made 











Annotated Bibliography 


BASIC PROGRAMS AND 
PROGRAMMING 


Osborne; McGraw-Hill is publishing twa BASIC tutorials, Armichals 
BASIC by David and Annic Fox 1s designed for the nonprogrammiet 
Microsoft BASIC Tutorial by Walter Ettlin and Greg Solberg, to be pub 
lished in 1983, is an introduction to the popular Microsoft BASIC language 

Two books on programming style should be read in tandem with any 
language tutorial. The Elements of Programming Style by Brian Kermphan 
and P.J. Plauger (McGraw-Hill Book Co.) and BAS/C with Styie by Paul 
Nagin and Henry Ledgard (Hayden Book Co,) will teach you how to wrile 
well-constructed, correct programs and introduce you to the clements of 
programming style. They are “must” reading for any BASIC programmer, 
[rom beginner to expert. 

Osborne / McGraw-Hill publishes three collections of BASIC programs 
Some Common BASIC Programs, Practical BASIC Programs, and Science 
aud Engineering Programs. 

Many computing magazines publish BASIC programs in cael Wwaue 
Check current ond back issues of Compute! Popular Computing, itu 
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HY TE fora start, Review these magazines and others to see which one is best 
suited to your background and interests. 

[he user’s manuals for Microsoft BASIC and snapBASIC contain a 
number of examples of complete BASIC programs, as well as excellent 
lutorials in BASIC programming. 


INFORMATION ABOUT SNAP AND FORTH 


Ihe SnapFORTH tutorial guide, distributed with the SnapFORTH 
capsule, provides an introduction to programming in SNAP. The 
snaprORTH reference manual, also distributed with the capsule, provides 
complete information on the SNAP language and the architecture of the 
HH from a programmer’s point of view. 

SNAP ts based on the widely available language FORTH. If you would 
like to learn FORTH in an easy, tutorial fashion, read Discover FORTH by 
Ihom Hogan (Osborne! McGraw-Hill). 


HHC HARDWARE 
service manuals and design specifications for the HHC are available to 
qualified parties interested in developing new HHC hardware products. 
Contact Panasonic, Olympia, or Quasar for information. 





Glossary 


This appendix defines the words and phrases that are printed in italics in 
the text. | _ 

Arranged for easy reference, each entry lists the chapter or appendix in 
which the term ts introduced in italics. 


AC Adaptor: a device that powers the HHC from AC power and 
recharges the HHC’s batteries (Chapter 2). 


Acoustic coupler: atype of modem that enables your HHC to communi- 
cate with another modem-equipped computer through a telephone 
handset. See “modem” (Chapter 9). 


Alarm: an entry in the HHC’s Clock; Controller. At a time that you 
specify, the alarm will “ring.” It will continue to ring at approximate 
ten-minute intervals—even if your HHC 1s turned off—until you enter 
the Clock; Controller and acknowledge the alarm (Chapter 5). 


ALL OFF switch: aslide switch inthe back of the HHC, so named because 1t 
controls the HHC’s power supply and can turn off all parts of the HHC 
(Chapter 2}. 

Assembler; a computer program that translates assembly language pro 
praind into machine language code (Chapter &). 


liz 
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Assembly language: aconvenient, human-readable notation used to write 


programs in machine language (Chapter 8). 


Attache Carrping Case: a specially fitted case that can hold an HHC and 
peripherals (Chapter 2). 


Atito-answer modem: a modem capable of responding, without human 
insistance, to a telephone call from another modem. Auto-answer 


modems are customarily used on time-sharing computer systems (Chap- 
ter 9), 


Auto-dial modem: a modem capable of “dialing” a telephone call under 
software control (Chapter 9). 


Autovofffeature: afeature of the HHC operating system that protects you 
from draining the HHC’s batteries should you forget to turn off the H HC: 
If you leave the HHC on for about ten minutes without pressing any key 
the HHC will turn itself off (Chapter 2}. | . 


Auto repeat: a keyboard feature that lets you enter a character many times 
while holding down its key. Most of the HHC’s keyboard keys auto- 
repeat, but the auto-repeat speed depends on the setting of the STP/SPD 
key (Chapter 3). 


Hack-up: afile copy kept ina safe place in case the working copy 1s lost or 
damaged (Chapter 6). 


Baud rate: the maximum rate at which data can be transmitted over a 
serial interface, Two serial devices must be set to the same baud rate to 
communicate with each other. If you use a rate of 300 baud—the most 
common setting for telecommunications and low-speed printers—the 
maximum rate at which data can be transmitted 1s 300 bits, or about 30 
characters, per second. “Baud” 1s a contraction of “Baudot,” the name of 
an early system for encoding character data in digital signals (Chapter 9). 


Hinary file: any file that is not a text file. SNAP files, Microsoft BASIC 
and SnapBASIC, and Portaflex program files are all binary files. Pro- 
grams generally use binary files to store “private” information. For 
example, the Telecomputing series of programs, which allow you to 
connect your HHC to other computers through the Modem, use binary 
liles to store information that is used to configure the Modem so that it 
can communicate with your type of computer connection (Chapter 3), 


Mit; the most elementary unit of digital information, A bit ean hive only 
Iwo values-zero or one, Digital computers represent all their data and 
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programs as strings of bits or strings of larger units of data (either bytes, 
characters, or words) composed of bits (Chapter 9). 


Blip: an indicator that gives you information about the HHC’s status, 
Along the bottom of the LCD, the HHC can display the eight blips 
“SHIFT,” “LOCK,” “2nd SFT,” “DELETE,” “INSERT,” “ALARM,” 
“ON LINE.” and “ce.” The rectangular blip has no fixed definition 
(Chapter 2). 


Buffer: (1) To save data temporarily until they can be accepted by their 
destination. Input is buffered between the time it comes in froma periph- 
eraland the time a program reads it; output is buffered between the time it 
is written by a program and the time it goes out toa peripheral, (2} When 
used as a noun, the word “buffer” refers to an area in RAM where data 
are temporarily stored (Chapter 9). 


Byte: aunit of computer memory that holds one character of information. 
RAM, ROM, and file sizes are customarily measured in bytes. On the 
HHC and most other computers, a byte consists of eight bits (Chapter 2). 


Carrier signal: acontinuous signal that can be modulated to make it carry 
information. Modulation is a change in frequency, amplitude, or phase. 
The radio frequency signal that the HHC’s TV Adaptor outputs through 
its “RF out” jack isa carrier signal modulated to carry a video image. [he 
high-pitched tone that you hear when you turn on the HHC’s Modem or 
dial up a modem-equipped computer on your telephone is a Carrier signal 
modulated to carry a stream of digital information (Chapter 9). 


CLEAR Key: akey onthe HHC’s keyboard that you use to reset the HHC 
when you have finished running most programs. See Appendix B for 
cautions on use of the CLEAR key (Chapter 2). 


Compiler: acomputer program that translates froma high-level language 
into machine language or into a pseudo-machine language that may then 
be interpreted (Chapter 8). 


Computer program: aset of instructions st ored ina computer and used to 
control the computer’s operation (Chapter 8), 


Control character: a“character” witha control function, such as ringing a 
bell or beginning a new line on an output device, This differs from the 
“printable character” that causes the deviee (a print o1 display symbols 
like "a," “3,” or “!" (Appendix D) 
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Crossed cable: an RS-232C cable in which certain pairs of pins are cross- 
connected from one end to the other. This cable is used to connect the 
Kis-232C Interface to a printer, display terminal, or other serial-interface 
device (Chapter 9). 


Current file: the file that the File System editor is creating or modifying at 
any given time (Chapter 3). 


Current file space: the file space currently “visible” to the HHC’s File 
system and to other programs that use files. The current file space is in 
ether tntrinsic (HHC) or extrinsic (PMP) RAM. See alse “intrinsic,” 
“extrinsic,” and “PMP” (Chapter 6). 


Current fine; the line in the current file that the File System editor is 
creating or modifying at any given time (Chapter 3). 


Cursor: asymbol] that marks the place where the next typed character will 
#0 on a display device such as the LCD. The HHC’s “normal” cursor is a 
flashing solid rectangle. The “insert” cursor is a rectangle filled with a 
checkerboard pattern. The “delete” cursor is an empty, outlined rectangle 
(Chapter 3), 


Debugging: the process of diagnosing and correcting errors in the logic of 
a computer program. For all but the most trivial programs, debugging is 
an unavoidable part of programming (Chapter 8). 


Device: anabbreviation of “peripheral device.” See “peripheral” (Chapter 
9), 


Device capsule: ROM mounted on a special plastic carrier. A device 
capsule contains control software for an HHC peripheral such as the 
Modem, it may also contain an application program. Plug the device 
capsule into a socket on the peripheral device it is designed to control 
(Chapter 7}. 


Direct-connect modem: a modem that interfaces directly with the tele- 
phone network. An acoustic coupler, in contrast, operates through the 
handset of a telephone (Chapter 9). 

Downloading: the process of transferring information (most often a 
source program or object program) from a host computer to a target 
computer, The opposite of downloading is “uploading,” that is, transfer- 
ring information from the target computer to the host (Chapters & and 9). 


PCH see “event control block” (Appendix C) 
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Editing keys: a group of keys on the right side of the HHC’s keyboard, 
Used primarily to edit data, the editing keys are +, —, 1, |, INSERT, 
DELETF, ROTATE, and SEARCH (Chapter 2). 


Editor: a computer program that can be used to create and modify text 
files. See “File System” (Chapter 3). 


ENTER key: a key located near the lower right corner of the HHC’s 
keyboard, Its action is similar to a typewriter’s RETURN key (Chapter 2), 


EPROM: see “erasable programmable read-only memory” (Chapter 8), 


EPROM burner: a peripheral device that records information, usually 
computer programs, on EPROMs (Chapter 9). 


Erasable programmable read-only memory (EPROM): a type of ROM 
that can be “burned” with a program, erased, and reburned. EPROMs 
are used to produce experimental, small-volume, custom programs in 
HHC capsules (Chapter 8). 


Event conirol block (ECB): a software control block that the HHC’s 

operating system uses, along with internal processing, to synchronize 
events such as the startup and completion of I/O operations (Appendix 
C). 


Extrinsic: added tothe HHC as an option or accessory, or attached to the 
HHC temporarily. The RAM ina Programmable Memory Peripheral is 
called extrinsic RAM (Chapter 6), 


Extrinsic RAM: RAMcontained ina Programmable Memory Peripheral 
(Chapter 6). 


File: a collection of information grouped together under one name. A 
computer program processes stored data by reading and writing the file in 
which the data are stored. You would work in much the same way witha 
conventional file—reading and writing your documents after retrieving a 
file folder from the filing cabinet (Chapter 3). =e 





File space: anareain RAM that the HHC uses to store files. This area May 
be the intrinsic file space in intrinsic RAM or an extrinsic file space in any 
Programmable Memory Peripheral (PMP) attached to the HHC (Chap- 
ter 6). 


File System: (1) One of the HHC’s three intrinate Appleations, which can 
be used to locate, rename, and delete files. The Tile Syaterm containa an 
editor that may be used to create and modify text files, (2) The part ol the 
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HHC's operating system that maintains HHC files in RAM, It is used by 
the bile System application to manipulate files (Chapter 3), 


Pile type: the characteristics ofan HHC file. They are stored with the file 
ut ‘ire ret visible when you look at the file with the File System, See “tex| 
file,” “invisible file,” “SNAP file,” and “binary file” (Chapter 3), 


Mloating point: 4 way Of storing numbers ina computer that can represent 
real numbers like 0.01 and 10,99 as well as integers like 0, 1, and 10, The 
HH ¢ s operating system contains software that Operates on floating 
point numbers with 13 decimal digits of precision, Microsoft BASIC has 
tis Own set of floating point software that operates on floating point 
numbers with nine decimal] digits of precision (Chapter 8), 


function keys: three keys labeled fl through £3, They let you enter [re 
quently used sequences of keystrokes by pressing a single key. You set the 
lunction keys’ definitions with the HELP key (Chapter 2), 


Graphics: computer output that takes the form of a picture rather than 
lext, Ihe HC can display limited graphics on its LCD. but its primary 
Kraphics devices are the Plotter and TV Adaptor (Chapter 9), 


HHC capsule: i ROM chip mounted ona special plastic carrier. An HHC 
capsule containing an HHC application program is plugged into one af 
the three sockets on the back of the HHC (Chapter 7), 


HEI P Rey: a keyboard key that displays a brief explanation of another 
Key § function, You also use the HELP key to define the function keyn 
(Chapter 2), 


Hivhelevel language: a programming language that is asy tO use because 
] A Fi , ‘ T ‘A ‘ a ‘ 
(expresses programs in terms of the problem to be solved rather than the 


oe the computer hardware must perform to solve them (Chapte 


Hast computer: | 1) Acomputer that is used to develop programa that will 
Ultimately he run on another computer, The host COMmMputer is selected 
because of ils speed or advanced capabilities, A computer with a fullealye 
keyboard and fast disk-based file stornge is often used a4 a host computer 
for developing HHC programs in SnaprOR TH ar SaapHASIC, (2) A 
larger computer that YOu comimuntente with through a modem, With a 
Modern peripheral, you ean transfer the cata that your PC collects in 
the Held toa lager database, See aly “medent” (Chapter Ay 
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Input: (1) The process of reading information into a computer. It is done 
through a peripheral or through an intrinsic device such as a keyboard. 
(2) The information that is read into a computer (Chapter 9). 


Interpreter: a computer program that executes programs expressed in 
pseudo-machine language. An interpreter examines the pseudo-machine 
instructions one by one and performs the operations those instructions 
would perform directly if the pseudo-machine were real]. See a/so “com- 


piler” (Chapter 8), 


interpretive execution: the process of executing a pseudo-machine lan- 
guage program with an interpreter (Chapter 8). 


Intrinsic: built into the HHC. The term is used to describe components 
and programs that are part of the HHC’s main unit. Its opposite is 
“extrinsic” (Chapter 3). 


Intrinsic RAM: RAMthatis built into the HHC. Its opposite is “extrinsic 
RAM” (Chapter 6). 


Invisible file: atype of hile that does not appear in the file menu presented 
by the File System editor, Any file may have the “invisible” file type in 
addition to its other types. Files that programs use to store “private” 
information are often invisible. The files that the Telecomputing pro- 
grams use to store their configuration parameters, for example, are 
invisible (Chapter 3}. 


f/Q: means “input and/or output.” I/O is any process that transfers 
information into a computer (input), out of acomputer (output), or both 
into and out of a computer (Chapter 9). 


[iO Adaptor: a plastic tray that connects the HHC to as many as six 
peripherals at once. The HHC slides into the lower right channel of the 
I/O Adaptor, and its peripheral socket connects toa plug onthe Adaptor 
(Chapter 2). 


i/O key; akey onthe HHC keyboard that displays the status of the HHC’s 
peripherals and RAM and allows you to change the current file space and 
turn peripherals on and off (Chapters 2 and 3). 


Keyboard overiay: a rectangular sheet of plastic that you place over the 
HHC’s keyboard when you are using a particular application program, 
The keyboard overlay relabels the keyboard keys to reflect the functions 
they have in a particular program (Chapter 2}, 





LOD; see “liquid erystal display” (Chapter 1). 


Library capsule: an HHC capsule that may be used as a “library” of 
kubroutines to be called by programs in other capsules or SNAP files, The 
scientific Calculator capsule is a library capsule (Chapter 7), 


Liquld crystal display (LCD): the HHC’s primary output medium, 
Located above the keyboard on the main unit, the LCD is an electronic 
device consisting of specially treated material placed between two glass 
plates. An electric field applied to the plates can make the material 
between them change from transparent to opaque, creating a visible 
image, The HHC’s LCD displays a matrix of square dots, 159 dots long 
and & dots high, The LCD can display as many as 26.5 characters 
(Chapter 1), 


LOCK key: somewhat like the SHIFT LOCK key ona typewriter. The LOCK 
key lets you “lock” the effect of another key (Chapter 2), 


Logtealunitnumber (LUN): anumber used internally by HHC programs 
to address @ specific device, that is, to tell the operating system which 
device an I/O operation is meant for, Logical unit numbers are associated 
with devices when the program is executed, making it easy fora program 
to operate different devices at different times (Appendix C). 


L{/N; see “logical unit number” (Appendix C). 


Machine language: the numerical “language” that a computer uses for its 
internal operations. All programs written in other computer languages 
ire ultimately translated into machine language before the computer 
actually acts on the instructions. Machine language is expressed in binary 
notation—that is, in combination of 0’s and t's. Each type of computer 
his its Own unique machine language (Chapter 8). 


Masked ROM: a type of ROM produced in large quantities with a pre- 
recorded program, The one-time cost of preparing to produce a program 
In masked ROM ts high (typically several thousand dollars), but the cost 
of producing each HHC capsule in masked ROM is low (Chapter 8), 


Memory: (1) Any part of a computer that stores information, particularly 
RAM or ROM. (2) An area of RAM reserved for use by the HHC's 
intrinsic Calculator and used to store an intermediate result while the 
Calculator is calculating something else, Four of the HHC's keyboard 
keys (CM, RM, Mer, and M }manipulate the Caleulntor's memory (¢ ‘hap 
ler 4) 
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Menu: a list of options similar to the menu found in a restaurant. The 
HHC presents its menus on the LCD, one option at a time, From this 
menu you can choose one item, To select your option, press the key 
indicated before the equal sign (Chapter 2). 


Modem: a peripheral device through which a computer communicates 
with another computer over a telephone line. A direct-connect modem 
connects directly to the telephone system through the modular jack in the 
wall, bypassing the usual telephone. A modem that operates through the 
telephone handset is called an acoustic coupler; it typically has a pair of 
cups that hold the two ends ofa telephone’s handset. An acoustic coupler 
is what most people mean when they say “modem.” The HHC’s Modem 
peripheral is an acoustic coupler (Chapters 1, 7, and 9). 


Object program: anexecutable program produced from a source program 
by a compiler or assembler (Chapter 8). 


OFF key: akey onthe HHC’s keyboard that turns off the HHC. See also 
“ON key” (Chapter 2). 


ON key: an HHC keyboard key that turns on the HHC. See aise the “ALL 
OFF switch,” which controls power for the HHC’s memory, processor, 
and LCD (Chapter 2). 


Operating system: a program that manages the HHC’s overall operation, 
It is permanently stored in the HHC’s intrinsic ROM (Chapter 2}. 


Output: (1) The process of writing information out from a computer. The 
information is transmitted through a peripheral or through an intrinsic 
device such as an LCD. (2) Information that is written out from a 
computer (Chapter 9). 


Peripheral: adevice that is attached toa computer for reading info rmation 
into the system (input), writing information out from the system (output), 
or both reading and writing (input/output or 1/O) (Chapter 9). 


Persistent memory: a feature that enables the HHC to preserve its File 
System files and “remember” its location in a program when turned off, 
With persistent memory, you can turn off the HHC while you are running 
a program. Later, when you turn it on, the program will run as though 
nothing had happened. Be careful, however. Some peripherals generate a 
spurious character when the HHC is turned off or on (Chapter 6), 


PMP: see “Programmable Memory Peripheral” (Chapters [| and 6). 
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Portablilty; the degree to which a computer program can be transported 
from one kind of computer or one environment to another and still work 
(Chapter &), 


Posting: the process of setting a bit in an ECB to indicate that the event 
represented by that ECB has occurred. ECBs are normally posted by the 
operating system (Appendix C), 


Primary menu: the HHC’s master menu. It tells you what programs are 
available in the HHC (Chapter 2). 


Printable character: a character that represents a number, letter, or punc- 
tuntion symbol, See afso “unique character” and “control character” 
(Appendix D). 


Program function keys: four keys in the lower left corner of the HHC 
keyboard, Labeled C1! through C4, they are used to control many of the 
programs that run on the HHC. They also sometimes function as typing 
keys and produce the special displayed characters “4,” “8,” “i,” and “n” 
(Chapters 2 and 6), 


Programmable Memory Peripheral (PMP): a peripheral device that con- 
tuins 4096, 8192, or 16,384 (4K, 8K, or [6K) characters of RAM to 
wugment the HHC’s intrinsic RAM (Chapters | and 6). 


Pseudo-machine language: an imaginary computer’s machine language: 
an easier target for translating a high-level programming language than 
the machine language of a real machine, Once a compiler has translated a 
source program into pseudo-machine language, the program may be 
executed by an interpreter (Chapter 8). 


KAM: random-access memory, RAM is used to hold data for the HHC’s 
operating system and programs and to store data files that programs 
operate on (Chapter 2). 


Kandom-access memory: see “RAM” (Chapter 2). 
Read-only memory: see “ROM” (Chapter 2). 


ROM: read-only memory, a type of computer memory that is “burned” 
with a program or other data and then cannot be changed, ROM holds 
the HINC’s operating system and intrinsic applications, In device capsules 
and MAC capsules, it is used to hold device contral routines and other 
Appliontion programs (Chapter 2), 
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RS-232C interface: a type of connection often used for communication 
between computers or between a computer and a peripheral. It is suitable 
for communicating data over distances as great asa few dozen feet and at 
speeds as high as a few thousand characters per second. It is also called a 
“serial interface” (Chapter 9), 


Scrolling: the process of moving information into and out of a computer 
display so as to show more information than will fit on the display at one 
time. Think of the display as a small window. Think of scrolling as a 
process that moves a large page of paper around behind the window, 
revealing different parts of the page (Chapter 3). 


2nd SFT key (second shift): a keyboard key that lets you type special 
characters. The HHC has a SHIFT key that lets you type capital letters and 
punctuation symbols; the 2nd SFT key gives you access to a third complete 
set of characters (Chapter 2). 


Serial interface: a type of connection often used for communication 
between computers or between a computer and a peripheral. The serial 
interface transmits information one bit at a time over a single wire. The 
most common type is the RS-232C Interface. In fact, the term “serial 
interface” is often used loosely as a synonym for “RS-232C Interiace” 
(Chapter 9). 


SHIFT key: a keyboard key that is somewhat like the SHIFT key on a 
typewriter. The SIINFT key lets you type capital letters and punctuation 
symbols (Chapter 2). 

Slaving: the process of writing output to another device as well as to the 
usual recipient, We say the second device is “slaved” to the first. You can 
slave a Printer, Plotter, or TV Adaptor to the LCD (Chapter 9}. 


Sleeve: arigid plastic object that slides into the groove around the sides of 
the HHC. You can use the sleeve to hold together the HHC and a 
peripheral, You can also slide the sleeve over the face of the HHC to 
protect the keyboard from accidental pokes (Chapter 2). 


SNAP file: a type of file that contains a runnable SNAP program. SNAP 
files appear in the secondary menu presented by the RUN SNAP PRO- 
GRAMS selection from the primary menu (Chapters 3 and 7). 


Source program: a program that can be compiled or interpreted. The 
result 1s an object program (Chapter 8), 


STP/SPD key: a keyboard key that lets you set the HHC’s LCD display 
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speed and keyboard auto-repeat speed or “freeze” the HHC while it is 
running a program so that you can inspect the output (Chapter 2), 


Straight cable: an RS-232C cable in which each wired pin of one plug ts 
connected to the corresponding pin of the other plug. This cable is used to 
connect the RS-232C Interface to a serial-interface modem (Chapter 9), 


fext file: a type of file that consists of lines of text, each of which ra nges 
from zero to 255 characters in length. Text files with lines no more than &0 
characters long may be created and modified with the File System editor 
(Chapter 3), 


fying keys: the keys on the left side of the HHC's keyboard, including the 
number and letter keys (Chapter 2), 


Unique character: a character that is unique to the HHC’s character set. 
Most of these characters are “printable” in the sense that they can be 
displayed on the LCD and some HHC peripheral devices such as the TY 
Adaptor (Appendix D). 


Uploading: the process of transferring data from a target computer to a 
host computer, See a/so “downloading” (Chapter 9), 


Video adaptor: a device for displaying digital information on a conven- 
ional television set. The HHC’s TV Adaptor is a video adaptor (Chapter 
9), 


Video monitor: a device that is similar to a television set but is designed 
specifically to display computer images. A video monitor accepts an 
image-forming signal used directly to deflect the electron beam in the 
display tube and is not encoded on a carrier signal (Chapter 9), 


Word wrap: a feature of many word processing programs, and one that 
also appears in several of the HHC’s peripherals, When a line of input or 
output is too long to fit on a peripheral’s output line or too long to fit 
between a word processing program’s left and right margins, word wrap 
begins a new line at the beginning of the word that does not fit. When no 
word wrap feature is present, the new line begins with the first character 
that does not fit on the old line (Chapter 9). 
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